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After Blue’s Gone 


Peter Kruger sees beyond the immediate ramifications of IBM’s impressive losses. 


‘Don’t Worry About IBM’ said the Financial Times, taking 
the view that the company’s problems were fascinating, but of 
little significance to the rest of industry. Can this be true? 

Five years ago, IBM seemed like a poker player with an 
infinite bank. If it lost every hand it played until the end of 
time, its losses would still be less than the interest it had 
accrued in the bank over the same period. 

IBM was, and still is, the strongest beast in the jungle, with 
strategic marketing departments and vast R&D facilities. It has 
been, until now, capable of taking on the biggest of predators. 
Sheer might, however, has not prevented it being stung to 
death by the ants nest of PC manufacturers into which it has 
wandered. The poker player with the infinite bank is now 
playing, and losing to, an infinite number of opponents. 

IBM is not alone in its plight. Similar problems are afflicting 
all manufacturing industries. Its competitors are unlikely to 
become as big as IBM itself - Intel 
and Microsoft may be growing 
rapidly, but it is doubtful if they will 
end up as large in terms of the 
number of employees. The nature 
of production is changing. Tradi- 
tional manufacturing companies, 
such as IBM, are in decline and 
may disappear altogether. 

At the tail end of the industrial 
revolution, a worker’s presence 
at the point of production relies 
more on the power of trade un- 
ions than on skills or abilities. We 
are both the producer and the 
consumer of goods and as, 
through automation, we have lit- 
tle involvement in production but 
still receive money, then it ap- 
pears we are actually paid to 
consume. Those who decide to remain producers find they 
need ever increasing levels of skills as technology takes more 
tasks from the worker. 

The design leaves via modem - seeking out lower wage 
rates like a virus searching a computer network for a host. 
The price of a PC is only marginally more than the cost of 
selling it - as communications become ever more sophisti- 
cated even this cost will fall. 

The drawback is that we will have no ‘work’. We depend 
on employment for identity. Do you remember Uncle asking, 
‘What will you be when you grow up?’ ‘Be’ equates to ‘Job’. 
Work is a ritual we need to express ourselves - without it we 
get depressed, drink too much and become ill. 

Work is becoming a pointless ritual. Old ladies visiting a 
church every Sunday doesn’t make God exist. The trade 
unions’ insistence that we are present at the point of 
production doesn’t make jobs exist. This problem lies at the 
heart of the decline of companies such as IBM. 

Organisations die just as organisms die. As years pass, my 
body will become less able to maintain its monopoly over the 
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space it occupies - already it has, since the age of 28, replaced 
less of its decaying cells each year. This natural process ensures 
continual development, one day my children will want to 
occupy this space - as each generation, through genetic 
refinement, improves on its predecessor. 

Man, however, not only occupies the space bounded by his 
skin, but is also able to re-create an environment which is best 
suited to his continued survival. Man’s occupation and shaping 
of his environment follows the same natural laws of ageing 
and dying for the same reasons as his body does - namely 
improvement through genetic mutation. If the environment in 
question happens to be a company - even one as large as IBM 
- it must still obey natural laws. 

To understand where we go from here, we must first come 
to terms with what has happened to us as individuals. We are 
marooned half way along an evolutionary journey. Our under- 
standing of what we are was 
frozen at the point where we 
became conscious of our own - 
here I am not aware of your 
existence nor you of mine. 

These are unconscious 
thoughts by a virtual person made 
up of you and me, together with 
any one of several other people 
who are reading this article. Your 
reaction to what I am saying - the 
resultant abstract thought - will 
find its way into an article or con- 
versation at some time in the fu- 
ture, and so the process will 
continue. You and I perceive our- 
selves as being only that which we 
are conscious of being - this is, 
however, merely a primitive sav- 
age whose perception of them- 
selves was frozen when communication between homo sapiens 
first began. We are now much more than that. 

The step from printed to interactive electronic communi- 
cation will provide a massive leap forward in this process, 
creating transient ‘virtual’ people who act collectively as a 
thinking entity with massive problem solving capabilities. 
We will be able to abandon sluggish linear thought proc- 
esses and will redefine the world around us using hypertext 
structures. 

The real challenges we face are not technological, but 
political and economic. Progress will depend on finding 
alternatives to production-based economic systems and 
alternatives to the organisations which make them up. 
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Peter Kruger is Managing Director of Digithurst Ltd (0763 
242955), and the author of three novels based on the subject 
of multi-media. He can be contacted on CompuServe at 
100034, 2300. 
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Paradox for Windows 


As predicted on the cover of last month’s .EXE, Borland’s Paradox for 
Windows has at last escaped the launch pad. The loss-leader introductory 
price (£99.95 until 1st May, when it goes up to £400) shows Borland’s 
determination to establish the product in the potentially lucrative xBASE-for- 
Windows market, but has it got the technology right? 

Initial tests at the .EXE office show that it might well have. The dreadful, 
klunky old Paradox interface has completely disappeared (no ‘compatibility 
mode’ here), to be replaced by an extremely slick Windows interface. Borland 
has assigned the right mouse button as a standard method to access the 
attributes of any screen object - for example, clicking on the background of 
a form produces a free-floating menu with items for colo(u)r, pattern and any 
ObjectPal methods attached to the form. This approach much reduces hunting 
through multi-layered menus. The report/form designer seems versatile and 
easy to use: there is a clever system of creating and displaying relations 
between tables, pretty graphs and all the de rigeur Windows trinkets -:button 
bars, OLE etc. 

From the Developer's angle: PAL has been replaced by ObjectPAL, an 
event-driven, not very object-oriented language (you can’t build your own 
classes), which reminded the writer strongly of Visual Basic. To respond to 
the action of a click ona push button in a form, for example, you simply add 
code to its pushButton built-in method, which is accessible through an 
object inspector. The syntax is similar to the old PAL but, given the differences 
in program structure, porting is going to be non-trivial. The development 
environment includes a debugger with trace and breakpoints. 

As shipped, P4W can access only dBASE and Paradox files; a SQL link to 
Oracle, SYBASE and InterBase will follow ‘soon’, but you will have to wait 
for IDAPI (see last month’s news) to read a DataPerfect database (shame). 
Reservations; it’s rather fat and slow - it was definitely waddling on my 8 MB 
RAM 40 MHz 386DxX, it is not nearly extensible as Visual Basic (no equivalent 
of custom controls) and - hard to quantify this - it’s just a little bit quirky. 
Users of Paradox for DOS will know what I mean. But it’s an extremely 
reasonable £100’s worth. 


Microsoft has created an API to the 


No merci for MS 
disk compression engine called the 


Stac Inc, the company which manu- 
facturers the Stacker range of disk 
compression products, is filing a law- 
suit against Microsoft for infringing 
Stac patents. Stac is claiming that pre- 
release versions of MS-DOS V6.0 use 
patented technology from Stac. The 
allegation concerns the disk com- 
pression element of the new MS-DOS 
which is based on the Lempel-Ziv al- 
gorithms. 


Microsoft Real time Compression In- 
terface (MRCI - pronounced ‘merci’) 
to enable developers to call disk 
compression/decompression ser- 
vices in their own applications. Stac 
claims that Microsoft has used two of 
its US patents in the MRCI API. Micro- 
soft was unavailable for comment, 
although we understand that MS- 
DOS V6.0 is scheduled to ship this 
month. 


RICHFORDS 
TRAINING 


Microsoft Development Tools 


WINDOWS Advanced Developer Programme. Using C++? 
PROGRAMMING OWL or MFC? The course for advanced 
WINDOWS programming. 
Intermediate Programming. For C programmers 
starting serious WINDOWS projects. 
VISUAL C++ C programmer moving to Visual C++? You need 
PROGRAMMING to know C++ and MFC. You need this course. 
VISUAL BASIC 2.0 Comprehensive training covering standard and 
professional editions. 
LAN MANAGER 2.2 Installation, support and programming - all in one 
complete course. 


C++ FOUNDATION The bridging course for professional systems 
developers with no C experience. 


C++ PROGRAMMING a Both courses have been designed for 
experienced C programmers who are 
C++ for WINDOWS Q working for software or systems houses. 


xBase Languages 
CA-Clipper 9 Recital Q Sycero dB 


CALL NOW 3 
FOnOuR RICHFORDS 
Ws CURRENT SOUTH BANK TECHNOPARK 90LONDONROAD 


g SCHEDULE LONDON SE1 6LN 
ed ail TELEPHONE 071 922 8819 


All trademarks acknowledged 


6 


_______ ——  _ ———ncrmememmmmammmmmmmmmmmy £o-/ 


age costs £69.95, call Fontware on 
0329 822857. 


UNIX catches up 

ObjectCenter 2.0 is a new release of 
the UNIX C++ debugger from Cen- 
terLine Software (formerly Saber). 
The star feature of this version is the 
ability to precompile header files to 
Speed up the edit/compile/link cycle 
- according to the manufacturer, 
ObjectCenter is the only UNIX C++ 
system that can do this. Centerline 
has also added template support, 
Motif and Open Look user interfaces 
and enhanced browsers. There is 
also an open API for the integration 
of other programming tools. Objec- 
tCenter 2.0 runs on Sun SPARCs 
and HP Apollo 9000s now, more 
machines will follow. K2 is the UK 
distributor on 061 776 4541. 


Free Case 

CRaG Systems is giving away fully 
operational copies of its SELECT/De- 
Marco CASE tool. This enables soft- 
ware developers of real time systems 
to create data-flow diagrams with 
Process Specifications and a data 
dictionary using the Yourdan meth- 
odology. It runs under Windows 
and comes complete with online 
documentation. To obtain your free 
copy send a 3 1/2" or 5 1/4" disk with 
stamped addressed envelope to CASE 
Tool Offer, CRaG Systems, 8 Shake- 
speare Road, Thatcham, Newbury, 
Berks RG13 4DG. 


Speaking Objects 

Object Technology ’93 is being held 
between 30th March - Ist April 
1993 at Jesus College, Cambridge. 
Speakers include Bertrand Meyer, 
father of Eiffel and Steve Cook, 
President of the BCS OOPS Group. 
There will also be a small exbibi- 
tion, Attendance costs £750 
(standard fee) or £600 for mem- 
bers of the BCS. To book, phone 
0491 410222, 


Totally UNIX 


Linux is a new multi-user UNIX op- 
erating system, based on SVR4, which 
runs in protected mode on a 386/486 
PC. It provides over 300 commands 
and comes complete with the X-Win- 
dows X11R5 windowing system (plus 
manuals), and GNU software develop- 
ment tools including C/C++ compilers, 
and GDB debugger. Source code for 
the kernel is provided. Linux requires 
a PC with at least 4 MB of RAM (8 MB 
for X-Windows) and 40 MB of free 
disk space (60 MB recommended). It 
is distributed on 40 (!) 1.44 MB disks. 
Linux is distributed by Unitech Sys- 
tems (0953 789345) and retails at 
£408. 


Complete Reporting 


Programmers who have used Bor- 
land’s ObjectVision Pro will be familiar 
with Crystal Report V1.0, the Win- 
dows-hosted report generator which 
came bundled with the package. Crys- 
tal Report V2.0 has now become avail- 
able. It provides support for many file 
formats including dBASE (with MDX, 
NDX and NTX indexing); Paradox 
V3.0, V4.0 and Paradox for Windows; 
FoxPro (CDX indexes) and Btrieve out 
of the same box. In addition, there is 
a SQL Edition for connecting to Oracle 
and SQL Server client-server data- 
bases, 

Reports can be sorted by record or 
by group. There are 75 in-built func- 
tions and developers can provide their 
own by coding them as DLLs. Other 
features include context-sensitive 


News 


help; the ability to print to file; support 
for embedding images into reports us- 
ing BMP, GIF, PCX, TIF or TGA graph- 
ics file formats; and the facility to 
create several types of mailing label. 

Crystal Report comes with a royalty- 
free Reporting Engine DLL which en- 
ables developers to distribute reports 
as standalone executables. Reports can 
be altered at run-time without the need 
to re-create the executable. Crystal re- 
port V2.0 retails at £129. It is distributed 
in the UK by The Software Construc- 
tion Company on 0763 244114. 


Hello to Halo 


Media Cybernetics has developed 
the Halo Imaging library (Halo), a new 
platform-independent C image proc- 
essing toolkit available for Windows, 
OS/2, Macintosh, Motif and Open 
Look. The library contains over 100 
image processing functions including 
routines to create and manage image 
files; convert from one format to an- 
other (eg from colour to mono- 
chrome); add special effects like 
adjusting brightness/contrast or pro- 
ducing overlayed images; rotate and 
flip images; and routines to read/write 
several standard graphics formats in- 
cluding TIFF, GIF, TGA, PCX, BMP and 
EPS. 

The library comes complete with 
example source for an application 
which demonstrates many of its fea- 
tures, including using platform-spe- 
cific image display and printing. Halo 
for MS-Windows costs &395 for a single 
user licence from System Science .(071 
8331022) 


Auto Ada tester 

Rational, the Ada specialist, has in- 
troduced TestMate, an automated 
software testing tool which enables 
developers to perform non-intrusive 
coverage analysis on Ada software. 
It also reports on which areas of the 
application have been tested. Test- 
Mate works in conjunction with Ra- 
tional Environment or the Rational 
Compilation Integrators, which en- 
ables testing to be performed on any 
target platform. The retail price is 
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DOS Apps Converter 


Short of rewriting the code, there isn’t an easy way to turn a DOS text-only 
application into a Windows application. MicroMini Systems has introduced 
GUI Assist, a tool for performing this task in such a way that the source 
code is left untouched. GUI Assist provides a Windows-hosted front-end to 
a DOS application which runs in a minimised DOS box under Windows 
Enhanced Mode. A developer creates the front-end in Visual Basic V2.0 for 
Windows (VBW) and communicates to the background DOS application 
using the GUI Assist DLL. Keyboard input is rerouted and output from the 
application can be read into a VBW text-box by extracting the text at 
specified screen coérdinates. 

An application is converted to Windows by mapping all text output into 
VBW text-boxes and trapping keyboard input. To ease this task somewhat, 
GUI Assist is shipped with a utility called Head Up which runs the DOS 
application, recording all keystrokes entered by the user and the coérdinates 
of text on the DOS screen. It then generates an output file containing the 
calls to the GUI Assist DLL which would need to be invoked in order to 
mimic the responses which the user had just made. A developer can copy 
and paste sections of this file into his VBW front-end in order to talk to the 
underlying DOS application. GUI Assist retails at £350 from MicroMini 
Systems on 081 3390739. 


SoftTools for the Job 


TbxSHIELD™ 


The fastest way to add new and innovative 
toolbox controls to an application. 


TbxSHIELD from Stirling Group provides a high level, object 
oriented tool box library to permit the creation of sophisticated 
tool box controls like - VCR Bar, Drag and Drop, rotating 
ToolCube, Toolbar, Button Bar and scrollable virtual Toolbox. 


Call back functions allow you to manage application code which 
responds to toolbox controls. 


TbxSHIELD is available for Windows and Presentation Manager. 
A demonstration disk is available. 


TbxSHIELD for Windows or OS/2 - £255 


C-scape® 


The latest release of the best selling character/graphics based 
screen interface library in the UK. C-scape from Liant Software 
Corp is run-time royalty free and prices include source code and 
the Look & Feel™ Screen Designer. 


C-scape is the most flexible interface package for text or graphics 
based applications with such powerful features as scrolling 
windows, mouse support, menus, text editor, help, data entry 
and much more. C-scape's object oriented architecture makes 
it easy to integrate with any other C library and applications port 
without modification across DOS, extended DOS, OS/2, UNIX, 
AIX, X Windows, QNX and VMS. 


Prices start from £370 
NEW - C-scape GDK - £550 


ResourceSHIELD™ 


The tool for visually creating, editing and translating all 
OS/2, Windows and Windows NT resources. 


Browse all your resources quickly using the visual resource 
Brower ls: Hundreds of resource templates get you started 
quickly. 


Resource translators allow you to translate resources between 
all supported platforms. 


ResourceSHIELD for Windows - £150 
ResourceSHIELD for OS/2 PM - £350 


Phar Lap 
286IDOS Extender™ 


With the 286IDOS Extender and your Microsoft C, Borland C++ 
or MS Fortran compiler you have all the tools necessary to 
quickly build protected mode applications - often by relinking 
without making source code changes. Protected mode 
applications can be built that access up to 16 megabytes of 
memory on any DOS 80286, 386, 386SX or i486 PC. 286IDOS 
Extender is also compatible with Borland's Turbo Debugger and 
Microsoft's linker and CodeView debugger. 


286IDOS Extender Software Development Kit - £360 
386IDOS Extender SDK For 32-bit languages - £360 


InstallSHIELD™ 


Build Bullet-Proof Installation Programs 


Used by some of the world's leading Windows and Presentation 
Manager applications, InstallISHIELD is available to create 
professional, bullet-proof installation programs. InstallSHIELD's 
powerful and easy-to-use script language provides an array of 
installation and file handling functions that you can use to create 
a wide variety of intelligent installation and file distribution 
applications. 


A demonstration disk is available. 


InstallSHIELD for Windows - £255 
InstallSHIELD for OS/2 - £510 


DOC™HELP® 


Hypertext Word Processing comes to 
Word for Windows 


Create documents and Windows Hypertext Help with 
Doc-To-Help. 

Doc-To-Help is for anyone who distributes information and who 
wants that information to have all the impact that professional 
documentation design and cutting-edge hypertext presentation 
can add. A product of WexTech Systems. 

A demonstration disk is available. 


Doc-To-Help for Windows - £260 


MagnaCharter Il 


Relieve the pain of drawing charts 


MagnaCharter || for Windows lets you build any kind of chart in 
minutes and includes all standard flowcharting symbols which 
are displayed as icons or add your own. Use the crowsfeet for 
database schemas. Features are accessed by drop-down 
menus, dialog boxes and multiple windows with a wide choice 
of text styles and sizes. Editing is simple ‘cut-and-paste’. 
MagnaCharter || appears as a 99x99 spreadsheet. A wide 
range of printers is supported as is PostScript. 


A demonstration disk is available. 


MagnaCharter Il for Windows - £160 


Other Products Distributed and Supported by 
Systemstar SoftTools: 


zApp New Version 2.0 Win, DOS Text or Graphics £245 
zApp New Version 2.0 Windows NT £300 
zApp New Version 2.0 OS/2 £420 
Object/Designer for Windows £360 
C++/Views Win £295, OS/2 £625, UNIX Motif £950 
ProtoView for Windows £350 
ProtoGen for Windows £190 
DataTable for Windows £235 
DbxSHIELD Windows £335, OS/2 £510 
LogSHIELD Windows £335, OS/2 £510 
DemoSHIELD Windows £335, OS/2 £510 
MemSHIELD Windows £335, OS/2 £510 


Please check price at time of order. 
Prices do not include VAT or carriage. 


For more information, 

demonstration disks or 
details of our 30 day trial 

offer call: (0992) 500919 


YSTEMSTAR 


SoftTools Limited 


1-3 Parliament Square Hertford SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 554261 
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$5000 per user. Rational is on 0101 
408 4963600. 


Non-client Control 

Control Palette/NC is a DLL which 
enables developers to alter the ap- 
pearance of the Windows non-client 
area, by adding three-dimensional 
effects to borders, title bars and 
menu bars. It is shipped with C++ 
support for OWL and MFC, a refer- 
ence manual and example code in 
C and Pascal. Control Palette/NC 
costs $169 (including source) from 
Blaise Computing on 0101 510 
5405441, 


RPC Generator 

EZ-RPC is a compiler and toolkit 
from NobleNet Inc which spews out 
the C code needed to create net- 
work-independent, distributed cli- 
ent-server applications. The 


company says that this product lets 
programmers who are unfamiliar 
with Remote Procedure Calls 
(RPCS) to write distributed appli- 
cations. It works by converting any 
C function into an RPC - the origi- 
nal source remains unchanged. A 
three developer licence costs 
£7750, EZ-RPC is distributed in 
the UK by Personal Workstations 
(071 231 0333). 


User-Conscious 

Software Design and Build is organ- 
ising a workshop on user-interface 
design which is to be held in Bristol 
on March 18th. The workshop is 
called ‘Design for use - The Process 
and technique for User Interface De- 
sign’ and covers the Ethos methodol- 
ogy. The workshop costs £250. 
Phone Camilla Hall on 0272 
308668 to register. 


Compiler ins & outs 

In addition to providing specific 
training in Borland C++ and Bor- 
land C++ for Windows, Richfords 
has added programming courses 
in Microsoft C V7.0 and Visual Ba- 
sic to the range of courses it offers. 
Courses are run monthly. For de- 
tails phone Richfords on 071 
9228819, 


Never too late 

Werre sorry that the our February 
issue was published a little later than 
usual: the .EXE editorial and pro- 
duction teams found a new DIP 
package rather more of a challenge 
than expected. However the good 
news is than now we have the thing 


NetWare/UNIX kit 


The NetWare NFS Starter Kit is a 
five-user version of Novell’s NetWare 
NFS product. One of the highlights of 
the kit is that it provides a facility for 
setting up UNIX accounts on a Net- 
Ware V3.11 server. It contains NetWare 
Loadable Modules for NetWare V3.11 
anda File Transfer Protocol (FTP) gate- 
way which allows an FTP client to gain 
access to files on any NetWare server 
on the network (even those that do not 
support TCP/IP). UNIX accounts are 
given bidirectional print gateways 
which not only gives them access to 
NetWare printer, but also allows Net- 
Ware users to print to UNIX printers. 
The Starter kit also contains an X Win- 
dows System console utility which en- 
ables the network administrator to 
perform remote network management 
from any workstation supporting the X 
Windows system. The NetWare NFS 
Starter Kit V1.2B retails at &1000. 

Novell has also released a free up- 
grade to Netware NFS V1.2 which adds 
support for Novell’s MultiProtocol 
Router V2.0 and LAN WorkGroup 
products. Novell can be contacted on 
0344 860400. 


Sycero V3.0 


The latest version of Sycero, the da- 
tabase application generator from Sys- 
tem C, now provides enhanced 
support for Clipper V5.01. It includes 
code blocks, multidimensional arrays, 
GET and ERROR objects, STATIC and 
LOCAL variables and formal parameter 
passing. Sycero sports a new front-end 
and the company says that the screen 
painter and data dictionary have been 
enhanced. In particular, the data dic- 
tionary now supports parent and child 
fields. When the definition of a parent 
field is changed, the child field is auto- 
matically updated. Other Features in- 
clude a browser which offers a ‘speed 
search’ facility like the one in Norton 
Utilities; and a report generator which 
enables several formats to appear on 
the same report. 


Sycero can also make use of Clipper 
third-party add-ons such as the Slx 
Replaceable Database Driver which al- 
lows the creation of applications 
which use FoxPro-style indexing. 
Documentation is now generated 
automatically. Sycero V3.0 retails at 
&595 for a single user licence. System 
C is on 0622 691616. 


EasyDBG 


Silicon Valley Software (SVS) has 
added a new debugger to its range of 
32-bit compiler products for the 
386/486. EasyDBG is a source-level 
symbolic debugger for the SVS lan- 
guage system products. It is able to run 
as a native 32-bit program under Win- 
dows or in DPMI-compliant mode un- 
der DOS or OS/2. Debugging of 32-bit 
applications can be performed using 
Fortran, C or Pascal-like syntax for 
displaying variables or tracing point- 
ers. EasyDBG retails at $195. It will also 
be bundled with the SVS Fortran, Pas- 
cal and C 32-bit language systems with 
prices starting at $429. SVS is on 0101 
415 5728800. 


LabWindows 


LabWindows from National Instru- 
ments is a toolkit which provides a 
way to write applications for data ac- 
quisition, analysis and presentation 
under MS-DOS. The latest release adds 
‘out of the box’ support for Borland 
C++/Turbo C++ and Visual Basic for 
DOS to existing support for Microsoft 
C/Quick C, LabWindows contains an 
instrument driver library for control- 
ling GPIB, VXI and RS-232 instruments 
from several manufacturers. The li- 
brary contains over 260 LabWindows 
instrument drivers and is regularly up- 
dated. This release also offers a float- 
ing point DSP Analysis library, DPMI 
support and a utility library of common 
DOS file/directory commands. Lab- 
Windows V2.2.1 costs £1918, although 
existing users can upgrade from V2.2 
at no extra cost. Phone free on 0800 
289877 for details. 


OLE, No NDA! 


Developers who want to register onto the OLE V2.0 beta-programme no 
longer have to sign a Microsoft non-disclosure agreement. OLE V2.0 is an 
enhanced version of Windows 3.1 Object Linking and Embedding which is 
to be incorporated into Windows NT. If you would like to join the 
programme, send an email request with your company name, address, 
phone and fax number to Scott Skorupa on CompuServe (76701, 53). Once 
your request has been processed you'll be given access to a private section 
(17) in the WINEXT forum where you can download the OLE V2.0 libraries 
and obtain responses to technical questions on OLE. 
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Problem : 


To Efficiently Store 
Complex Real World 
Objects in a 
Database. 
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POET’s Object Oriented Solution 


"Announcing POET, the first true Object Oriented Database 
system for DOS, Windows, UNIX and NeXT, with prices starting 
from just £249" 


The Affordable Database Solution. Object-oriented programs allow us to declare new What Should You Do? 


Up until now, object oriented DBMSs have 
typically only been available on high end UNIX 
machines, with prohibitive entry prices of 
$20,000++. Now you can unleash the power and 
potential of a true OODBMS in your DOS or 
Windows application, at prices starting at £249 
+VAT. 


Object Oriented DBMS v Relational 

Relational Database (RDBS) and B-Tree/ISAM 
systems require that data be portrayed as a series 
of two dimensional tables. These systems were a 
real breakthrough in their time, but software 
developers are rapidly learning that life is not a 
series of two dimensional tables. 


For example, a CAD program might have an 
array of shapes, or a DTP program might model a 
page as a series of frames which might contain 
bitmaps, paragraphs or vector drawings. 
Conventional databases have a fixed set of data 
types. And the only way they group data is in a 
table. 


All trademarks acknowledged 


data types as needed. And POET stores the 
objects we create as objects. This one-to-one 
correspondence of the database design to its 
physical storage can realize access gains of over 
one hundred fold compared with relational 
DBMSs. POET has the speed while keeping its 
kernel small; the DOS runtime is under 256Kb. 


POET includes complete 
support for C++ inheritance 

and encapsulation, class 
dictionary with class 

versioning, optimized indexing 
and querying, object caching, 
complex operators and con- 
tainers. POET has what it takes. 


Persistent Object Extended database Technology 
POET took over 20 man years to develop by 
leading German Software house BKS. In non 
German speaking Europe itis distributed by 
Silicon River Limited, the same team that first 
popularized C and C++ in the UK by aggressively 
pricing Zortech C/C++. 


This is the powerful, flexible database technology 
you have been awaiting, Now it is not only 
available, but affordable, If you will be developing 
a database application on any of the platforms 
below, then please call for a free Technical 
Overview of POET, the object oriented DBMS. 
engine for the 1990s. 


Platforms Supported: 


Borland C++ (DOS or Windows) 
Microsoft C/C++ 7.0 (DOS or Windows) 
Zortach C++ 3,0 (DOS or Windows) 


LPI C++ (UNIX 386 Systems) 
HP C++ Softbench 
GNU C++ (NeXT Step) 


For your free POET Technical Overview call 


061317 7/77 


Silicon River Ltd 58-60 Beresford Street, LONDON, SE18 6BG 
Voice 081 3177777 Fax 0813167778 BBS 081 317 2310 


Kivey 


Letters 


Letters 


We welcome short letters on any subject that is relevant to software development. Please write to 
The Editor, .EXE Magazine, 10 Barley Mow Passage, Chiswick, London W4 4PH. Unless your letter is 
marked ‘Not for Publication’, it will be considered for inclusion in this section. 


The point of GUIs 


Sir, 

I feel compelled to put burnt-carbon 
to paper after reading the Soapbox arti- 
cle ‘The Pre-Neanderthal User’. It is one 
thing to have an objective opinion on a 
subject, for example the relative merits 
of GUI, but it is obvious that Dana 
O’Kearney simply dislikes GUIs because 
he wants to. 

No-one expects a complete novice to 
sit behind the wheel of a car and imme- 
diately drive without tuition. If you have 
to consult the manual for your new 
video camera after you have unpacked 
it, no-one will label you a moron be- 
cause of it. Yet Mr O’Kearney seems to 
feel that the GUI fails for this very reason. 

His ‘test’ of giving a task to a computer 
novice and having them fumble through 
it via a command line and a GUI is not 
exactly rigorous. So the subject eventually 
found DELETE after her third attempt? 
What do you think her chances would 
have been with, say: COPY C:\DOCU- 
MENTS\INTERNAL\LETTER.DOC 
D:\MAIL\OUTTRAY\*.ATN /A /V? 

The novice’s comments after the test 
are also damning of Mr O’Kearney’s 
argument. The first two comments Cie 
‘How should I know that the mouse, 
not the cursor keys, move the arrow 
on-screen and that you need to hold 
the button down to drag?’) can again 
be compared to the analogy of learn- 
ing to drive. If a novice driver tried to 
change gear with the indicator arm 
instead of the gear lever, or didn’t hold 
the clutch down while changing gear, 
would you blame the car? The blame 
lies squarely with the tuition (or lack 
of it), not the tool. 

The GUI is the way forward in com- 
puter interfaces, if only because it 
allows millions of normal people ac- 
cess to the power of a computer with- 
out having to learn arcane languages 
and carrying around weighty tomes 
for constant reference, but instead 
merely applying principles that they 
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have already used all of their lives. No 

amount of closed-minded opinions or 
bias will change that. 

Jeremy Kimmons 

Thornton Heath 


May-Day! 


Sir, 

I write with reference to the news 
item entitled ‘S.O.S. Help Builder for 
Windows’ in .EXE February '93. 

I would be grateful if you would 
publish this letter to draw the attention 
of your readers to the fact that ‘S.O.S. 
Help Builder for Windows’ is in no 
way connected with Lamaura Devel- 
opment Ltd, or our own product ‘SOS 
Help!’. Furthermore, neither Lamaura 
Development Ltd nor myself have any 
connection with Seddon-Eaton Sys- 
tems Ltd or A.B.C. Software. 

SOS Help! is and remains a trade 
mark of Lamaura Development Ltd. 
The Windows version of SOS Help! 
will ship within the next few weeks. 

Philip de Lisle 
MD, Lamaura Development Ltd 


Long Shifts in BP 7.0 


Sir, 

The just-released Borland Pascal 7.0 
is a worthwhile upgrade to previous 
issues, though code optimisation is still 
disappointing. 

However, the publicised optimisa- 
tion to 32-bit operations contain a se- 
rious error in 32-bit shifts of more than 
16 places. For example 


program BUG; 


var L : longint; 
begin 
L := $87654321; 
writeln($87654321 shr 28, 
to Doshr 28) 
end. 


displays ‘8 30296’ ($00007658) in- 
stead of the expected ‘8 8’. The prob- 
lem arises from clearly erroneous code 


in the runtime library which tries to 
make use of the 80386 shrd and shld 
instructions, but gets it wrong. The first 
result is calculated by the compiler 
which obviously uses a different library. 

The easiest fix is to suppress all 
80836 instruction set optimisations by 
starting the program with: 


{ If 80386 select 80286 } 
if TEST8086 = 2 then 
TEST8086 := 1; 


The more adventurous can locate 
the code in the appropriate libraries 
and patch the jumps over the 80836 
instructions to unconditional, thereby 
leaving other optimisations intact. In 
each of TURBO.TPL (real mode) and 
TPP.TPL (80286 protected mode) find 
2 byte sequences of 02 72 06 and 
change each 72 to EB. 

Roy D Battell 
Technical Director, 
Computamation Systems Lid 


ObjectVision Anonymous 


Dear Sir, 

I am considering setting up a user 
group for users of Borland ObjectVision, 
if I can find sufficient people who are 
interested. The plans are to do a regular 
newsletter and maintain a bulletin board 
for swapping ideas and programs. 

Perhaps anybody interested in the idea 
of a UK ObjectVision User Group would 
contact me at the address given below. 

Tony Jaques 

TJ. Techniques Ltd 

82 Upper George Street 
Chesham, BUCKS HP5 3EH 
(Tel 0494 783229) 


Letter of the Month 


The writer of the best letter of the 
month, as judged by the Editor, will 
receive a £20 book voucher, cour- 
tesy of Just Computer Books. The 
best letter is the one printed first. 
Please note that letters submitted to 
this page may be edited. 


If you are not using Eiffel are you sure that 
your software is really object oriented? 


Up until now there have been two ways in which to 
successfully implement the Object Oriented paradigm: 
Management and Language. 


Now there’s a third! 


APPLIED LOGIC 


@ Object oriented technology 
© Object oriented training 

® Object oriented consultancy 
@ Systems Integration 


With Eiffel technology you can produce optimised C 
code easily whilst ensuring quality documentation and 
maximising reusability. 

Eiffel is available on: 

MS-DOS, OS/2, Sun Sparc, DEC, HP, IBM, SCO, 
NeXT and a wide variety of other UNIX platforms. 
Call us now and find out how Applied Logic and Eiffel 
technology can help your company: 

Applied Logic 

9 Princeton Court 


55 Felsham Road 
London SWI5 


Tel: 081 780 1088 rE 
Fax: 081 780 1941 Applied Logic 


Special discounts now available for academic institutions 


THE INSTITUTION OF 
ANALYSTS & PROGRAMMERS 


EO é 


id 


Founded some 20 years ago, the Institution is 
Britain’s leading specialised professional body for 
systems analysts and computer programmers. 


The Institution’s primary aim is to promote 
vocational skills and professionalism. It also seeks 
to support members in a number of practical ways. 
Members are entitled to use the Institution's 
designatory letters as a mark of professional status. 


Applications are welcomed from all men and women 
engaged in systems analysis or programming, and 
from those training for the profession. 


Telephone Fax 
081-567 2118 Pe 081-567 4379 


The Institution of Analysts & Programmers 
Charles House, 36 Culmington Road 
London W13 9NH, England 
> CIRCLE NO. 628 


O 
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SOFTWARE 
DESIGN @ BUILD 


A full day guided workshop 


User 
Interface 
Design 


Thursday 18th March 1993, 
on board S.S. Great Britain, Bristol 
£250 +VAT 


Contact: Camilla Hall 
0272 308668 


RENT 


‘Communication and Telemetry Consultants 


BEWARE THE 
PIRATE'S 
PATCH! 


You sell your software. 

You don't give it away. 

It needs the kind of 

copy protection that 

only a top quality 

UNPATCHABLE 

dongle affords, but 

you don’t want to & = 

pay the Earth for it, and you want to be sure that you'll not be 
making mistakes in incorporating it into your code. The 
MAXPRO system is for you. There are microprocessor based 
units at realistic prices which take care of complete .EXE files 
without access to source code. Set stop dates, tamper detection 
and many other facilities on a menu driven attachment program. 
MAXPRO encryption even copes with such as Clipper, QB and 
Clarion files with internal overlays. Neat trick. There are 
dongles available for Windows applications too! Call us for 
additional information at: 


> CIRCLE NO. 629 


Brent Communications 
Unit 2 

Dragon Industrial Estate 
Harrogate (UK) HG1 SDN 

Tel: (0) 423 566972 

Fax: (0) 423 501442 
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Processor Design 


Fitting a processor to C 


C is famous for being portable between CPUs of different architectures. 
But some platforms are more equal than others, as AMD’s Daniel Mann explains. 


One of the purposes of programming 
in any high-level language is to im- 
prove programmer productivity. Use 
of a high-level language enables a 
software professional to concentrate 
his efforts on developing application 
code; and not be burdened by imple- 
mentation details of the machine that 
runs the program. Another is to allow 
optimisations to be applied automat- 
ically to programs to increase their 
performance. Again, the idea is to free 
the programmer from the necessity of 
knowing the implementation details of 
the machine running the programs. 


However, to be efficient, the ‘gap’ be- 
tween the programming abstractions 
supported by a high-level language 
and the machine instructions should 
not be too large. The C language has 
a few ideas that relate to the underly- 
ing machine built right into the lan- 
guage; a good example is the 
register keyword. In the machines 
in common use when C was devel- 
oped, a register was a scarce resource, 
and frequently a compiler could do a 
much better job of obtaining perform- 
ance while hiding implementation de- 
tails, if only the programmer would 
give it some hints. For example, saying 
thisvariable has such an important effect 
on performance that it should always be 
maintained in a register helped the com- 
piler allocate registers more effectively. 


So built into the C language is the idea 
that register usage strategies affect com- 
piled code performance, and that ex- 


fib (n) int n; 

if 

int result; 

if (n <= 2) return 1; 

result = fib(n - 1) + fib(n - 2); 
return result; 


} 


Figure 1 - C Source code for 
Fibonacci functions 
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plicit changes in those strategies, at 
programmer's request, can be benefi- 
cial. 


The machines available today, and 
likely to be commonly used in the near 
future, have architectures that relate 
more closely to the way C operates. No 
longer are registers a scarce resource. 
Compilers have become much better 
at identifying which are the most im- 
portant variables to have in registers, 
and procedure calling conventions 
have been devised that greatly reduce 
the overhead of making C procedure 
calls. (A calling convention is a set of 
rules by which one procedure calls 
another and how they agree to com- 
municate data). One effect of this is 
that the factors which control a pro- 
gram’s performance are less in view to 
the C programmer. In other words, it 
matters a lot less these days whether 
you put the register keyword on 
all the right variables, and it matters a 
lot more how the compiler you are 
using utilises the capabilities and reg- 
ister organisation of the underlying 
machine that will ultimately execute 
your program. 


To illustrate how register usage strate? 
gies in CPU architectures and compiler 
systems affect the performance and 
size of your program at run-time, this 
article discusses register usage strate- 
gies for two popular processors. Two 
basic register-set schemes are re- 
viewed: 


@ The 386 processor is considered as 
an example of a fixed register set 
architecture. This is the common 
scheme with which most program- 
mers will be familiar. It can be found 
in the Motorola 680x0 architectures, 
DEC VAXes, MIPS machines and so 
on. 


@ The register set usage schemes of 
the 29K™ RISC family is included 
as representatives of the Register 
Stack approach. This CPU architec- 
ture implements a modern register 
resource scheme where registers are 
more conceptually related to the 
run-time stack than distinct from it. 
The scheme is known as ‘register 
windowing’. The SPARC processor 
from SUN is a well known RISC 
processor which employs register 
windowing. The 29K family, with 
the support of its microcontroller 
family members, brings the method 
to the embedded processor commu- 
nity. However, there are some im- 
portant differences between the 
SPARC and 29K family register ar- 
chitecture. The SPARC method re- 
lies on allocating a fixed size 
window (16 new registers) to each 
procedure; the 29K family allocates 
variable sized windows. 


Compiler output code for each of the 
processors is presented, and discussed. 
The discussion is directed to the relative 
merits of the different register 
schemes rather than the merits of in- 
dividual compiler implementations. 
We are more interested in the limita- 
tions or advantages of the various 
schemes than whether the compiler 
finds every possible optimisation 
within a particular scheme, 


A procedure, fib(), producing the Fi- 
bonacci sequence is used to demon- 
strate the register usage strategies. The 
source code is shown in Figure 1 (par- 
don my preference for K&R convent- 
ions). It was chosen because it is small 
and recursive, and thus demonstrates 
the caller and callee operation in one 
function. It can not be considered rep- 
resentative of a ‘typical’ procedure, but 
it does highlight a number of interesting 
issues. 
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The Professional Programmer’s Editor from Premia. 


Your Breakthrough Editor 

You need a powerful editing engine. The kind you 
just don’t get from an "integrated" editor. You 
want an editor that’s a good fit with Windows. 
Editors that are slow, or run in a DOS Window, or 
are just plain strange don’t cut it. Codewright 
gives you the power and Windows-fit you need to 
make Windows programming really work for you. 


With Codewright, you're not shackled by what 
features could be ported from a Unix or DOS 
editor. Codewright was built from scratch for the 
Windows environment. Yet with a choice of CUA, 
Brief, or vi style command sets, Codewright is 
instantly familiar. 


Command Sets 
CUA |) BRIEF | vi_| 


Support for 


es es co 
xaos | 
Ps tags J) soc 


"If you need a professional-quality editor 
[for Windows] Codewright is by far the 
leader of the pack." 

Daniel Appleman, 

Windows Tech Journal, Aug. ’92 


Power You Crave, in Windows 
Codewright has the basic features you may have 
found missing in other editors: column blocks, 
bookmarks, regular expression searches, 
unlimited line length and file size and Unlimited 
undo/redo. We give you compile/find errors, 
auto-save, and language templates, too. 


But Codewright goes far beyond the basics to offer 
Hex and Selective Display modes, File Find, File 
Grep, File Differencing and File Merging, an 
interface to your Version Control, ChromaCoding, 
and a Spell Checker with code smarts. 


Codewright’s integration with Windows is optimal: 
Common Dialogs, TrueType, Drag and Drop file 
loading and text editing, Tool Ribbon and Tool 
Box, MDI, and DDE. 


Yours to Configure, Extend. 
You configure Codewright through its dialogs and 
by editing its initialization file. When you need 
more customization, you can extend Codewright 
through Dynamic Link Libraries (DLLs) -- Not in 
some weak "C-like" macro language either. Use 
your real C compiler, or any other language that 
can generate a Windows DLL. 


We provide the C source to our DLLs -- over 
50,000 lines of source code to serve as examples, 
or for you to modify as you see fit. You can use 
any of Codewright’s 700 API functions or your 
own function libraries to make our editor truly 
yours. 


Break Free Tomorrow 

Don't let the limitations of your present editor be 
a barrier to better programming. Call us, or one 
of the Dealers listed below, today. We'll arrange 
for you to try Codewright. 


Briefusers: 

Protect your investment 

Now Codewright runs your compiled Brief macros 
under Windows at no extra charge! It’s as close 
as you'll get to Brief for Windows today... Possibly 
ever. For details, call and ask about B-Terp. 


"f ‘you decide to move to a Windows- 
based editor, Irecommend Codewright. 
Its interface ‘and documentation are very 
well designed, its defaults follow 
Windows conventions, and it is the most 
configurable and extensible package..." 
Bruce Graves 

Computer Shopper, Dec. 92 


In the U.K. contact: 


Roundhill Computer Systems, Ltd. 
Wiltshire Telehone 0672 84 535 
Tote 
Grey Matter, Devon 
Telephone 0364 53499 


Or order direct: +1-503-641-6000 
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Plus Shipping Premium Quality Software 


1075 NW Murray Blvd., Suite 268, Portland, Oregon 97229 USA 
Fax: +1-503-641-6001 CIS: 70673, 2627 


Brief is a registered trademark of Borland Int'l. Premia is a registered trademark of Premia Corp. Codewright is a trademark of Premia Corp. 
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The 386 Processor 


The 386 product range from Intel and 
AMD is well known, and many engi- 
neers are familiar with the instruction 
set. The instructions are not intended 
to operate in a single cycle as with 
RISC machines. Briefly, there are 8 
general purpose 32-bit data registers 
(EAX, EBX, ECX, EDX, EBP, ESP, ESI 
and EDI); one condition flag register; 
and other special purpose registers - 
but these play a lesser role in deter- 
mining efficiency in supporting high- 
level languages. 


A few instructions assign specific regis- 
ters for operands: register ESP is main- 
tained as the memory stack pointer; 
register EBP is the local frame base 
pointer. At entry to each function the 
stack pointer (ESP) is copied to the local 
frame pointer (EBP). All temporary func- 
tion-scope variables (auto variables) and 
passed function parameters are refer- 
enced relative to register EBP. 


The Fibonacci function was compiled 
onan IBM PC using the Metaware High 
C 386 compiler. We would expect to 
see that the compiler output contains 
a smaller number of complex CISC 
instructions. The code produced ap- 
pears in Figure 2. 


386 Parameter Passing 


All parameters are passed on the 
Memory Stack. In the Fibonacci ex- 
ample, each procedure frame re- 
quires 24 bytes of stack memory (see 
Figure 3). This is a smaller memory 
requirement than some RISC proces- 
sors, with respect to external memory 
usage once the internal memory or 
register supply has been depleted. 
On entering a procedure, only three 
of the eight general registers are con- 
sidered free. Registers EAX, EDX and 
ECX are volatile and their contents do 
not survive across a procedure call, 
The remaining five general registers 


are nonvolatile: the caller expects their 
contents to remain intact when the 
called function returns. A procedure 
which requires the use of nonvolatile 
registers must first save them on the 
memory stack. 


In the example code, the caller’s 
frame pointer (EBP) is pushed on the 
stack on entry to fib(); this entry 
code is known as the prologue. The 
frame pointer is then established to 
point to the base of the called func- 
tions Memory Stack frame. If the 
fib() function required space in its 
frame for local variables or compiler 
temporaries, the stack pointer would 
now be lowered by the required 
amount. In this case there is no 


sub esp, n 


instruction, as filb() can maintain all 
temporaries in processor registers. 


Registers EDI and ESI are used by 
fib() code. Since they are nonvola- 
tile, they must be pushed on the stack 
for safe keeping before the body of the 
f£ib() code commences. 


The small size of f:ib() makes it easy 
to study; the pushing of the n-1 and 
n-2 parameters onto the Memory Stack 
can be clearly identified before the 
recursive calls to fib() are executed. 
The result of fib(n-1) is saved in 
register EDI before it is summed with 
the fib(n-1) result. Data register 
FAX is used for return value passing. 
Depending on the size of the return 
value (integer in our example), volatile 
registers or a memory addresses pro- 
vided by the caller are used to return 
results. 


Although the parameter passing 
method is data memory intensive, reg- 
isters which are not used by a function 
are never pushed out on the stack, ie 
the general purpose registers are never 
saved in their entirety when a new 
function is called. 


Processor Design 


The £ib() function contains 25 in- 
structions. This is surprising, as it is 
more instructions than the 29K RISC 
processors presented below. RISC 
processors are typically reported to 
require 20% more memory for holding 
program code. All of the instructions 
are multi-cycle, and many access ex- 
ternal memory. Although the calling 
convention is memory intensive, the 
mechanism does not force the storing 
and loading registers which do not 
contain relevant data. This can hap- 
pen with processors (typically RISC 
or RISC-like) which do not support 
dynamic sized register allocation for 
procedures. When fixed sized regis- 
ter windows are flushed to external 
memory, all the registers in the win- 
dow are copied to memory, even if 
some of the registers assigned to the 
window are unused by the associated 
procedure. 


The 29K family 


The Am29000 processor has 65 global 
registers (called gr1, gr64-gr127). Six- 
teen of these, g96-g111, are used for 
procedure temporary variables, and 
also for the first 16 words of return data 
(similar to the 386’s eight global regis- 
ters). Most of the other global registers 
are not affected by the compiler di- 
rectly, making them available for op- 
erating system optimisation. A small 
number of global registers are assigned 
Register Stack support tasks. The proc- 
essor has other special purpose regis- 
ters which do not play an important 
rule in high-level language support. 
They are generally accessed in super- 
visor mode and by machine-level in- 
structions. 


There are also 128 local registers (Ir0- 
1r127); these are allocated to caching 
function frames. Procedure frames are 
allocated from a Register Stack in vari- 
able sized blocks. These register 
blocks, known as procedure activa- 
tion records, overlap and are used to 


+ compiled using hc386 -S -07 
} version v2.33 from Metaware 


fib near 
ebp 


ebp, esp 


proc 
push 
mov 
iframe pointer 
iprotect edi and esi 
i register: 
rget n from stack 
DWORD PTR 8[ebp] 
esi,2 i 
$L1 
eax,1 


edi 
esi 


push 
push 


mov 
cmp 
ig 
mov 
pop 
pop 
leave 
; then pop frame pnt from stack 


esi 
edi 


irepair protected 
rregisters - 


ipush frame pointer on stack 
copy stack pointer to 


push on stack 


pop off stack 
icopy frame pnt to stack pnt 


SL1: 
lea 


eax,-1le 


push 
call 
xchg 
adda 
push 
call 
ada 
add 
pop 
pop 
leave 
; then pop frame 
ret 


eax, 
esp, 
esi 
edi 


spop return address of stack 


here if n > 2 
si] ;calculate n-1, 

jusing adds. arith. 

pass n-1 on stack 

sive call fib(n-1) 
result to edi register 
late n-2 

ss n-2 on stack 

;fib(n-2), push return address 


to stack pointer 

¥ protected 

¢ XS - pop off stack 
icopy frame pnt to stack pnt 
pnt from stack 

pop return ads of stack 


Figure 2 - Compiled code for 386 processor 


14 


.EXE Magazine, Vol 7, Issue 9, March 1993 


pass outgoing parameters to child func- 
tions. A called function receives its in- 
coming arguments by ‘reaching’ into the 
overlap region of its own frame and its 
caller’s frame. 


The registers holding the outgoing pa- 
rameters are referenced by the callee 
to access its incoming parameters (see 
Figure 5). Global register gr1 is used to 
point to the base of a Register Stack. 
Function frames for non-leaf proce- 
dures have a minimum size of 4-words. 
Local registers allocated per procedure 
are referenced via the register stack 
pointer. The stack pointer (gr1) moves 
down the stack with each new proce- 
dure call, and back up when a return 
instruction is issued. The Register Stack 
is located in external memory, except 
for the most recent 128-word entries, 
which are cached in the processor’s 
local registers. 


On entering each function a test is 
performed to see if there is sufficient 
room remaining in the cache to hold 
the callee’s frame. If there is not, then 
some part of a previous function frame 
located at the bottom of the stack is 
‘spilled’ out to external memory, When 
returning from a function call, a test is 
also required to ensure that the now 
active frame is completely located in 
the cache. If it is not, because it was 
previously spilled, then it must be 
‘filled’ back in. All non-leaf functions 
suffer the overhead of the ‘spill-fill 
tests, but fortunately they do not re- 
quire many instructions. Function 
frame register Ir1 is used to support the 
fill test. Register Ir0 is also pre-assigned 
as the return address pointer for any 
functions called. 


The benefits of this method are that 
external memory is only accessed 


when the cache is full or needs refresh- 
ing. This does not happen often be- 
cause there are 128 local registers, and 
each function is allocated the mini- 
mum number of registers required. 


The fib() function was again com- 
piled, this time using the AMD High C 
29K compiler product (version 2.0). The 
code produced appears in Figure 4. 


Using Register Windows 


After the stack pointer has been low- 
ered, the incoming parameter ap- 
pears in local register Ir6 (the caller 
placed it in 1r2). Function fib() 
does not have any call-by-reference 
values but if it did they would be 
passed on a separate external Mem- 
ory Stack. If there was insufficient 
local register space to hold the nec- 
essary parameters, then the Memory 
Stack would handle the additional 
pass-by-value parameters. Software 
convention allows up to 16 local reg- 
isters to be used for parameter pass- 
ing. Additional, local registers may 
be allocated for function temporaries 
and outgoing parameters to any 
called functions. Procedure fib() 
only requires one local to store the 
result for £ib(n-1) before fib (n- 
2) is called. Because fib () requires 
only one parameter register, and it is 
the only function which fib () calls, 
the minimum frame size of four 
words is all that is required. 


Performance 


RISC processors achieve their higher 
performance by keeping the pipe- 
lined execution unit busy. Assuming 
zero wait state external memory, all 
Am29000 processor instructions 
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produced by the compiler are capable 
of operating in a single cycle except 
load-from-memory and store-to-mem- 
ory multiple (a single instruction with 
the 29K processor). The pipeline will 
only stall for instruction branches 
which are not supplied by the on-chip 
Branch Target Cache memory (BTC) or 
instruction cache memory; this results 
in a 2-cycle stall. Additionally, stalling 
will occur if a data store is requested 
and the following instruction requires 
the result of the store. This results in 
a 1-cycle stall. None of these condi- 
tions apply with fib/()- there are no 
explicit load/store instructions, and 
since the function is recursive the BTC 
is certain to have cached instruction 
entries after the first function execu- 
tion. 


The Am29000 processor has ‘delayed 
branching’. This means the instruction 
following branch and call instructions 
is always executed. If no useful in- 
structions can be found to fill the ‘delay 
slot’ then NOP instructions must be 
used. The compiler has successfully 
filled the five delay slots which appear 
in the fib() function. 


One cycle is lost due to the delay effect 
of modifying the Register Stack pointer 
(grl). The processor does not support 
modification of local registers in the 
cycle following a change to the local 
register base pointer (gr1). No local 
register independent instruction could 
be found, and a NOP has been in- 
serted. 


Assuming Register Stack cache spill- 
ing and filling are not required, the 
estimated number of cycles required 
for a simple fib(1) call is a mere 
10. At 25M HZ processor speeds, this 
is 0.4 micro seconds - making it easy 
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Figure 3 - The 386 Memory Stack Frame for fibO 


Figure 4 - Compiled code for Am29000 processor 
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ij £/ 


to see why RISC processors have a 
reputation for speed, even when used 
with C. The Register Stack memory 
requirement would be 4-words, a 
small portion of the 128 registers avail- 
able. 


higher address 


parent procedure's 


Conclusion 


When a register windowing scheme is 
used, and the windows are not fixed in 
size, a greater number of registers are 
made available to the programmer com- 


stack support 
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pointer 
(top of stack) 


of ——— 10 | 


stack support 


return address 


in-coming parameter 


out-going parameters 


base of 
procedure's frame 


Figure 5 - The 29K Memory Stack Frame for fibO 
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pared to processors which have a fixed 
number or registers or multiple sets of 
register windows of fixed size. This 
offers a significant performance ad- 
vantages, since it is likely that any 
variable upon which a programmer 
might wish to place the ‘register’ key- 
word is more likely to be found in a 
register than in external data memory, 
and hence be accessible in fewer pro- 
cessor cycles. The implicit register 
usage strategies of current compilers 
can also make effective use of placing 
data in registers rather than memory, 
particularly for RISC processors where 
data addressing modes are most effi- 
cient for register-based data. By allow- 
ing for compile-time determined 
window sizes rather than hard-wired 
fixed window sizes, the need to flush 
and restore registers to external mem- 
ory is reduced. 
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Daniel Mann is an ex-patriot Brit 
working as an engineer for AMD in 
Austin, Texas. He may be contacted by 
email as danm@cayman.amd.com. 
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The Most Powerful 
Program in the World 
Determined to make those 
long years pay olf, he called 
on every distributor, VAR and 
dealer in the world. He drove 


from Beantown to San Diego. 


Flew from Dublin to Borneo. 
Everyone loved the program. 
So he sold a few. Only 

a few. 
Back in Boston he 
waited. Alter a long year 


with only 13 orders he set 

out to see what happened. 

As he drove across the 

* country and 
\ flew around 

the world he 
discovered everyone 
knew about his program. 
Everyone had it too. 


The Global Marketplace 
From Paris to Prague, his 
program was everywhere in 
Europe. When he got off the 
plane in Hong Kong he found 
his program stacked to the 
ceiling in every computer 
store. Amazed in disbelief, he 
bought a hundred cartons 
of cigarettes and a hundred 
pounds of Indonesian 
coffee and flew back 
to Boston. 

Beaten, battered 
and bruised he went 
back to the drawing 
board. This time he 
would really 
change the face of 
the software industry. 
He would develop a device 
that would prevent 
unauthorized distribution 
of software programs. 


Call it What You Like 
He developed a hardware 
key. His peers applauded his 
efforts, Finally, a solid solution 
for revenue protection. 


But he didn’t know 
what to call it. He thought 
of naming it after an exotic 
place he visited in his travels. 
Madagascar was a bit too 
long, though. 

“Name it after you, 
Don!”, urged his peers. 
So he did. Soon 
everyone was calling 
the key a dongle, © 
alter Don Gall — . 
the lonely soltware 
developer who did 
what he had to do. 


You've Come 
A Long Way, Baby 
Today, dongles are different. 
Fact is, they've come a long 
way. Leading the 
industry with 
security solutions, 

*— Rainbow Technologies 
has changed the face of 
hardware keys. They work 
with multiple applications, 

are programmable and 
network versions control 
concurrent usage, And 
they're always transparent 
to the end-user. 

Sentinel Family 

from Rainbow 
Truth is, more and more 
developers are using keys. 
And the Sentinel Family is 
the most widely used in the 
world. In fact, over 6,000 


developers use Sentinel from 
Rainbow. Why? They are 
simply the most effective, 
reliable and easy to implement 
keys on the market, 

Learn more about securing 


yy your software 
w and how keys 
provide developers 
with extra value, 
Call for a free copy 
of “The Sentinel 
Guide to Securing 
Software.” And see 
just how easy it is to 
install a hardware 


key into your Ne 
application in just ge S 
minutes. Try it fe 
with our low cost gry) 
Sentinel SR 
Evaluation Kit. € 


Order one for 

your DOS, OS/2, Windows, 
Macintosh or UNIX based 
application. 

And remember, when 
you need a dongle, you need 
Sentinel —the only dongle 
Don Gall would use. 


Call us now for 
your free 
evaluation kit 
an mm fists) eel 
Sena intel 


Securing the future of software 


Some call it a dongle. Those who know, call it Sentinel. 
@GRAINBOW 


TECHNOLOGIES 


Rainbow Technologies Ltd, 4 The Forum, Hanworth Lane, Chertsey, Surrey KT16 9JX 
Tel: 0932 570066 Fax: 0932 570743 
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PC In Control 


The C language and the PC lend themselves well to the control and monitoring 
of scientific experiments. Alastair MacLeod looks at ways of making the connection. 


Large scale scientific experiments have 
for some time been computer control- 
led, but there is also a wide area of 
application to take the tedium out of 
small ‘bench top’ experiments - for 
instance to let students have more time 
for the real science. Of course, not all 
experiments can benefit by adding 
computer control, and it is important 
to develop experimental skills rather 
than hand everything over to the com- 
puter. But there are nevertheless many 
situations in which the computer has a 
real contribution to make. 


My purpose here is to discuss several 
methods of interfacing, and to say 
something of their relative merits in 
different situations - the kind of infor- 
mation which is most helpful when 
someone with no previous experience 
of interfacing is wondering which 
route to follow. I have also included 
some code examples which I hope will 
encourage those who might otherwise 
be frightened off by the prospect of 
working at this level. 


General considerations 


The binary 1 and 0 of the computer 
are, of course, available to the interface 
as high and low voltage levels. ‘These 
are often directly useful for opening or 
closing transistor switches, controlling 
Light Emitting Diodes, or for reading 
status flags or the open/closed state of 
toggle switches. 


However, a large area of interfacing 
has to do with Analogue to Digital 
Converters (ADCs) and Digital to Ana- 
logue Converters (DACs). The essen- 
tial point is that the computer operates 
with high and low voltage levels, com- 
bined to form binary numbers (or 
codes), but the real world operates 
with quantities whose values vary con- 
tinuously and might typically be pre- 


.EXE Magazine, Vol 7, Issue 9, March 1993 


sented as a voltage on a single wire. 
All forms of electronic control depend 
on the fact that all quantities - current, 
temperature, light level, flow rate, dis- 
placement, velocity - can be converted 
to a voltage on a single wire, so the 
problem of interfacing reduces to one 
of converting between the continu- 
ously variable voltage on a single wire 
and the high and low levels repre- 
senting binary numbers on groups of 
wires - typically between 8 and 16. The 
DAC converts from a binary number 
output from the computer to a voltage 
level on a single wire, while the ADC 
converts from a voltage on a single 
wire to a binary number which can be 
read into the computer. 


A DAC operates very simply. When a 
binary number is fed to it, the voltage 
on the output wire adjusts to the re- 
quired value, typically taking a few 
hundred nanoseconds to do so. 


The operation of the ADC is rather 
more complicated. The ADC is in- 
structed to start a conversion sequence 
by sending a strobe pulse to its START 
CONVERT pin. While the conversion 
is in progress a BUSY signal is held 
high by the ADC, and at the end of the 


conversion a DONE signal is output 
from the ADC. The BUSY and/or 
DONE signals are normally wired back 
to the computer so that their state can 
be polled from within the program. 


Interface Design 


Two important decisions have to be 
made before details of interface design 
can be considered: 


@ How fast a response is required 
from the instrument, and how fast 
must data be read? Ifa slow response 
is satisfactory then a simple interface 
will be adequate, possibly using ex- 
isting ports on the computer, like 
LPTn and/or COMn. In this respect, 
a response if less than 1 millisecond 
should be considered as fast, while 
a response which is slower than 10 
milliseconds is slow, with a middle 
region of response times where 
more detailed consideration of the 
timing constraints would have to be 
given. 


@ Will the apparatus have its own inter- 
nal intelligence? By this we really 
mean, will it have an in-built micro- 
processor acting as its own controller? 


8 8 8 8 8 8 
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Figure 1 - Circuit card with 48 parallel I/O lines 


“You only need to buy one copy! They don't protect with DESkey.” 


DESkey — Software Protection from the 
inventors of the intelligent Dongle. 


We have more experience and expertise in the design of 
software protection modules (dongles) than any other 
company in the UK. We sell products designed in house by 
ourown engineers. More than |3 years experience in the 
design of dongles have gone into our current product 
range. 


@ DESlock® automatic.EXE or,COM file encryption system. No 
need for source or.OB} files, Takes only a few seconds to protect 
your software — now available for OS/2 and Windows. 

@ ‘Seedable’ Pseudo Random Number Generator: 
Software and data encryption could not be more secure. 
@ Through Encryption, Data can be fed into the 
DESkey for on-line encryption. This keeps the 
encryption key hidden. 
@ Memory. Up to 240 bytes of memory split 
into ‘Public’ and ‘Private’ sectors, The ‘Public’ 
sector may be read from and written to at 

will. The ‘Private’ sector may be read at will, 
but writing requires your customer specific 
password. 

@ Down Counter. You program into the 


DESkey the number of times the program will run before stopping. 
This gives you the ability to sell 'goes' of your software rather than 
an open licence to use it forever—or even to senda fully working 
demonstration copy that will stop working after say, | 0 goes. 
@ Variable Response Algorithm. This feature is similar to the well 
known ‘public-key’ algorithm and works in conjunction with an 
algorithm on the host computer, Makes any attempt at software 
emulation impossible. 
@ Secure Memory Read. Even ifthe same memory data is read 
repeatedly, the data retumed from the DESkey never appears the 
same —this also makes the DESkey impossible to emulate. 

@ Parallel, Serial or Bus versions available. 
@ Intelligent Serial devices suitable for any operating 
system such as Unix, Xenix, OS/2, DOS etc. 
Works on any hardware including PC 
Networks, Mini Systems or even 
Mainframes. 
@ Free evaluation Kits. 
@ Guaranteed Exclusivity to all our 
customers. 
@ Fast Order Turn-round. 
@ Sold only through Data Encryption 
Systems Limited, 


Edbrook House, FAST 
Cannington, Bridgwater, 

Somerset, TAS 2QE "Sree en 
Telephone 0278 653456 ; ete Data Encryption Systems 
Fax 0278 653300 Data Encryption Systems Limited isamemberof FAST 
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The microprocessor program will be in 
ROM, so any changes which have to 
be made to it require an EPROM 
blower and rather specialist knowl- 
edge. Without this, you are restricted 
by the things which the microproces- 
sor has been programmed to do. On 
the other hand the microprocessor is 
able to do tasks itself when it is in- 
structed, and it can decipher complex 
messages. This means that the hard- 
ware in the interface can be simpler, 
since the firmware is doing the hard 
work. However, if there is no micro- 
processor in the unit, then the com- 
puter program itself is in complete 
control, and development of the sys- 
tem involves writing this computer 
program. 


COMn and LPTn 


Interfacing through one of the stand- 
ard computer ports is straightforward 
- this is the method used for printers 
and modems. A printer is an example 
of a device with its own internal intel- 
ligence. Many different codes are send 
to it, to define the print mode, set bold 
or underline, superscript or subscript 
and so on. These control codes set up 
the printer, and then the data is sent 
and printed in the required manner. 


Lab equipment often behaves in an 
analogous way: you send a character 
(escape code) to tell the unit which 
feature you wish to set up, then send 
further character(s) as data for this 
particular operation. Notice this ap- 
proach dooms you to incorporate ‘in- 
telligence’ into your unit. 


However, the printer is a mechanical 
device which will inevitably take some 
time to carry out the actual print op- 
eration, so there is no great concern 
that the handling of control informa- 
tion and data is rather slow - especially 
when using a serial interface. At 9600 
bps on a COMnh line, it takes about 1 
millisecond to send each character, 
which means that the response is slug- 
gish, especially if many characters are 
sent within each message. 


Communication back to the computer 
from the unit is possible on COMn. 
Possibly a special single character 
would be sent by the computer, to 
instruct the unit to send back some 
specified data, and the computer 
would wait to read this data. 


Communications on the LPTn ports are 
much faster. Borland’s Turbo C bios- 
print () function checks that the busy 


/* Read a binary number and display 
it in decimal on the screen*/ 

/* Use the PC30B ciruit card */ 

flinclude <stdio.h> 

base 0x700 

porta base+8 

portb base+9 

etrl base+11 


define 
fidefine 
define 
define 
main() 
( char ch; 

outportb (ctrl, 0x90); 

do 

{ 


/* Set up the ports */ 


print£(*Set number on switches, 
& press any key"); 
geteh(); /* Pause for any key! 
ch = inporth(porta); /* Read switche! 
printf ("Decimal td, hexadecimal ¢x\n", 
ch,ch); 


print£("Do you wish to continue? 
y/n\n"); 
while (((ch = getch()) != 'y’) && 
(ch t= 'n’)); 
) 
while (ch == ‘y'); 


) 


Figure 2 - Read and display an input port. 
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Figure 3 - Circuit card to combine a serial and a parallel port 
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signal is not high, then sends both the 
8-bit parallel data and a strobe pulse. 
This function allows an 8-bit data byte 
to be sent in about 40 microseconds. 


It is possible to receive data on the 
eight data lines, but there is no Turbo 
C function to do this, so you are forced 
to use methods similar to those de- 
scribed below for handling informa- 
tion on the computer’s input/output 
bus, by addressing the port in question 
directly. The parallel port is strictly not 
intended for receiving data on its data 
lines, but with care it can be done. 


Data can be sent back to the computer 
on the LPTn status lines, but all status 
lines are not free for use; in particular 
the BUSY line, when held high, will 
freeze the biosprint () function un- 
til BUSY is returned to the low state. 
Also, the BUSY line is neither the most 
significant nor the least significant in 
the byte, so the number on the other 
lines is not easily extracted from the 
byte to make a 7-bit binary number. 


Nevertheless, communication on one 
of the ports is certainly the best option 
in cases where speed is not important, 
and where you have the facilities to 
develop the microprocessor program 
required in the unit. 


Bus Interface 


There are many bus interface printed 
circuit boards available, Alternatively 
you may consider making your own, 
specially designed to meet the needs 
of your application. The input/output 
bus must be connected to all devices 
in the computer (except the memory 
chips), as well as your interface card. 
Data is sent by the computer on the 
data bus lines. It also sends a strobe 
pulse to the required destination, so 
that the data is received by only that 
one destination. Your interface must 
not draw too much current from the 
bus lines, and it must have a latch chip 
at its input, to hold the data in your 
interface while the bus is subsequently 
used to send data to other destinations. 


Greater care must be taken if your 
interface is to send data to the com- 
puter along the bus. It is important that 
only one unit at a time should attempt 
to control the 1s and Os on the data 
bus, since otherwise one unit will at- 
tempt to make some bus lines high 
while another unit is trying to make 
them low. For this purpose special chips 
are available which have tri-state out- 


When protecting your software against piracy and 
unauthorized use, make sure that your protection 
system has all the following qualities: 


A GOOD HARDWARE KEY 


Hardware-based software protection systems are now the 
standard worldwide. However, not all keys are the same. 
A good key should have all the following features: 


VY Compatibility and transparency. The key should 


, work without any problem on your 
| customers’ computers. The user should be 
i able to forget the key after connecting it. 


V Unbreakable electronics. A customized ASIC 
(Application Specific Integrated Circuit) component 
should be integrated in the key. This prevents reverse 
engineering and makes cracking virtually impossible. 


V Aunique and inaccessible software developer's 


code burnt into the ASIC. (This code should not be held in the key’s memory, 
where it can be read and altered.) 


V ARead/Write Memory inside the key should be available on demand. 
The memory should be writable in the field, on any PC, without any special 
programming equipment. 


V Very low power consumption, enabling the key to work even under the 
worst power conditions, on PCs and laptops, with or 
without a printer, 


POWERFUL SOFTWARE 


V ALinkable Protection Module with 
which calls can be made to the key from any 
point in the protected program. 

V An “Envelope” installation program. Such 


programs enhance security while making it possible to 
protect a software even without its source code. 


V Sophisticated antidebugging and encryption mechanisms. 


HASP - The Professional Software 
Protection system 


HASP® OFFERS YOU 

ALL THESE FEATURES 

AND MORE: 

HASP was designed by a team of computer ex- 
perts, professional cryptologists, and electrical 
engineers. As a result, HASP keys are supported 
by what is probably the best software in the mar- 
ket, and the HASP system has worked on every 
computer it has been tried on. In addition to all 
the features mentioned above, HASP provides: 


WHAT OTHERS ARE SAYING 
ABOUT US: 


In all the products we tested, except the 
HASP, we could see through the encrypting 
and questioning procedures... and crack 
them. 

CT Magazine (Germany) May ‘90 


OPERATING 

ENVIRONMENTS 

V PC: DOS, WINDOWS, 0S/2, SCO UNIX, 
SCO XENIX, INTERACTIVE UNIX, AIX, 
AUTOCAD, DOS EXTENDERS, LANS 

V MAC (ADB port): System 6.0.5 and up 

V NEC (Serial Port): DOS, WINDOWS 


AND THE BOTTOM LINE: 

We offer some of the most competitive prices in 
the market. There are no hidden costs! Since 
1984, HASP has enabled thousands of software 
producers in more than 40 countries, including 
several Fortune 500 companies, to protect their 
software. 


MemoHIASP: ...of all the protection devices 
tested is without any doubt, the one which 
combines the best features. 

PCompatible (Spain) Dec. ‘90 


‘Trying to crack a program... that was pro- 
tected utilizing all of HASP’s features - is like 
searching for the Holy Grail. 

Micro Systems (France) Dec. ‘90 


V Aull Authorization System for protecting 
dozens of programs using only one key. 

V A Pattern Code Security System (PCS) 
enabling parallel processing of multiple calls by 
the Linkable Protection Module. 

V A Virus Detection option that can be in- 
corporated in the protected program to check 
whether it has been infected by a virus. 


V Several HASP keys can be connected (daisy- 


Please call us for our HASP evaluation package. 
chained) one behind the other. 


PC dongles... come with varying claims as to 


NETHASP- THE ULTIMATE 
SOFTWARE PROTECTION 
FOR NETWORKS 


V Only one NetHASP key is needed to run a 
protected program from many stations in a 
network, NetHASP provides full support for 
protecting DOS and WINDOWS software under 
network environments, including Novell 
dedicated & non-dedicated servers, Lan Manager, 
Lantastic, Banyan, DLink, and NET-BIOS based 
LANs. 
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their transparency. The majority suffer from 

problems when a printer is connected... the 

DESkey and HASP-3 are not affected... 
Program Now (Britain) May ‘92 


Of all keys tested, HASP is the most 
ambitious one... the quality of HASP 
manufacturing seems excellent. 

PC Compatible (France) June ‘92 
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puts. These output lines can be either 
high or low, or they can be high 
impedance, in which case they leave 
the bus free to be driven from another 
interface. 


interface chip used in PCs is 
the Intel 8255. The chip has a control 
register and three data input/output 
registers, and therefore occupies four 
locations in input/output address 
space. The control register defines 
each port as an input or an output, and 
also defines the mode of the port - 
whether it is a simple input/output 
port or whether interrupts are gener- 
ated in the chip when data is written 
to it or read from it. Commercially 
available printed circuit cards allow 
two such chips to be wired, allowing 
6 ports or a total of 48 bits of data to 
be written or read very fast. When this 
data is written to the port it is latched 
into a register on the chip, and so is 
available for use in your unit, until it is 
overwritten by other data sent to the 
same port. Similarly data can be read 
from the port at any time, since it is 
held static on the port lines by your 
unit. The chip has the necessary tri- 
state output onto the computer bus. 


A typica. 


Eight-bit DACs and ADCs can be wired 
to a register (or port) in the 8255. 
Converters with more than eight bits 
must, of course, use two ports. 


Ifa commercially available printed cir- 
cuit card is used then you are likely to 
be supplied with a set of functions on 
floppy disk which will allow you to 
access all the facilities on the card 
without knowing much about the de- 
tails of their operation. But if you make 
your own then you will certainly have 
to come to terms with the technology. 


As a very simple example, Figure 1 
shows a circuit card with two 8255 


CURRENT 


VOLTAGE 


Figure 4 - 
Diode characteristic curve 
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* Take data for a 
Diode characteristic curve * 
/* Use the PC30B circuit card */ 


#include <stdio.h> 
define base  0x700 
fdefine dac base+20 


/* low byte of adc, 8255 port 0 * 
#define addatl base 

/* high byte of adc, 8255 port 1 4LSB*/ 
#define addath base+1 

*status register, 8255 port 1 4MSB*/ 
#define addsr addath 

*ade control register, 8255 port 2*/ 
#define adccr base+2 

/*adc mode, 8255 control register */ 
#define admde base+3 


int readade (int); 


main() 

{ int data; 
/* configure ade ports */ 
outportb(admde , 0x92) ; 
/*channel 0, software strobes * 
outportb(adccr,2); 
for (i=0;i<256;i++) 
{ /* output voltage through dac */ 


outportb(dac, i); 
/* diode volts */ 


volts{i] = readadc(1); 
*diode current */ 
current[i] = volts{i] - readadc(0); 


/* display current / voltage graph */ 


| | 
) 
) 


int readade(int chan’ 

{ unsigned char data; 
/* select channel */ 
data = chan<<4 | 2 
/* generate strobe for adc */ 
outportb(adcer, data) ; 
outportb(adcer,datal1); 
outporth(adcer, data); 
/* wait for ‘DONE’ on bit 6 of port 1 */ 
while (!(inportb(addsr) & 0x40)); 
/* return data from port 0 and 

4LSB of port 1 */ 

return (inport (addatl) & 4095) 

} 


Figure 5 - Take data for a 


chips, giving six 8-bit ports. The de- 
coding is arranged to select the base 
address of each chip. Suppose that the 
lines of port A are all connected to 
switches, which we will wish to read 
into the computer, and that the lines 
of port B are all connected to Light 
Emitting Diodes (LEDs) which can 
therefore display any single byte pre- 
sented to them from the computer. 
The program in Figure 2 gives a 
simple demonstration of displaying 
binary numbers read from an input 
port. 


At a more advanced level, one may 
purchase a circuit card with four DACs, 
an ADC multiplexed to read from 16 
independent voltage sources and 24 
parallel input/output lines. We have 
had considerable success in our teach- 
ing program using PC30B circuit cards 
which have these facilities. We have 
written our own software to drive this 
card, although some is supplied ready- 
made with the kit. 


Even more sophisticated circuit cards 
are available, as complete data acqui- 
sition systems. See the section below, 
for a description of some more ad- 
vanced applications of these systems. 


Combining COM and LPT 


Clearly bus communication gives the 
fastest control over your system. But 
there are two problems. First, circuit 
cards are fine for any ISA or EISA PC 
compatible computer, but special 
cards are necessary for the PS/2 and 
other MCA machines. This spells 
trouble if you want to develop a unit 
for use on either system. Second, the 
bus access on laptops and notebooks 
lies somewhere between the very lim- 
ited and the non-existent. 


diode characteristic curve 


These difficulties do not exist if you are 
using LPT] or COM1 for your commu- 
nications, since these ports are avail- 
able on all computers. But you may 
still wish to avoid the complications of 
intelligence in your unit, so what can 
you do? 


One possible step is to use fewer than 
eight bits of a port for data, setting 
aside one or two bits to define the 
location or purpose for which the data 
is intended, But sending less than eight 
bits of data at a time is decidedly 
limiting and inconvenient. 


To get round this, we have developed a 
system using both LPT and COM1 to- 
gether - one mainly for the data, and the 
other principally to define where the 
data is to go. Figure 3 gives an example 
of a simple circuit board which we fitted 
into one of our units. The eight data lines 
from LPT1 drive an internal bus within 
the interface. This bus is wired to all the 
data inputs of all the latches which must 
receive and hold the data which has 
been sent. However the strobe pulse, 
which is sent by the computer when 
data is transmitted using the bios- 
print() function, is gated to clock 
only one of the latches, thus defining the 
latch which actually accepts the data. 
The four least significant bits of the serial 
line select the destination for the strobe 
pulse. The data is then sent on LPT1. 
One bit in the status register of LPT’ is 
used to return a flag to the computer, 


It should be noted that one of the 
destinations which can be selected is 
the printer itself, so provided the unit 
is switched on you can still print from 
your program. 


When a byte is received from COM1 by 
the UART, the Data Ready signal is sent 


HAVE YOU GOT 
THE VISION? 


See your way clear to 
good design for £195 


If you are developing in C++, you'll want to take a very Implement the Design Factor. C++ Designer is 
close look at C++ Designer™ — a powerful multi-user developed around a powerful Object Oriented design 
Windows based design tool specifically for users of methodology - Rumbaugh’s Object Modelling Technique 
C++. The unique combination of graphical design tool (OMT). Rule and consistency checking are built-in, 
with C++ code generation will save time and effort — making C++ Designer an extremely effective aid to 
and help you design better systems! good design. 
Adopt the Visual Approach. Instead of # Simplicity is the Key to ensuring that tools 
struggling with lines of code, C++ Designer re are used effectively. With C++ Designer it’s 


easy to pick up and get started. An intuitive 
user interface, on-line help and tutorial 
ensure that users get that maximum possible 
benefit right from the start. 


lets you visualise the system you are 
designing by moving and manipulating objects 
graphically on screen. 
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to the Data Ready Reset after a delay 
of about 1 microsecond, so that further 
bytes can be received successfully. The 
4 least significant bits of the byte are 
coded to open one of the OR gates, so 
that the strobe pulse, which comes auto- 
matically when data is sent on LPT1, 
latches the data into one of the four 
possible destinations. The LPT1 data is 
available to all the latches, but only one 
of them is clocked by the strobe. 


The greatest complication in this cir- 
cuit is the handling of the status lines 
to the parallel port. As stated above, it 
is essential that the BUSY line should 
be low, to allow the biosprint () 
function to operate. This line can be 
tied permanently low if you do not 
wish to use the printer at all. In order 
to allow use of the printer, we have 
arranged that bit 6 of the serial byte 
will force BUSY low when we wish to 
latch other registers, but when we are 
using the printer the NAND gate is 
opened to allow the BUSY signal from 
the printer to pass back to the com- 
puter. The other status lines present 
much less of a problem since they do 
not automatically inhibit the 
biosprint() function. We have 
shown one of these status lines being 
gated by bits 6 and 7 of the serial byte 
to allow a response to be returned 
from our unit when the printer is not 
selected, but when the printer is se- 
lected all the status bits from the printer 
are allowed to pass to the computer. 


It is not difficult to see that the 4 least 
significant bits of the serial byte could 
be fed to a data selector (eg the 74154) 
which, when strobed by the LPT 
strobe, could strobe one of up to 16 
different destination latches. In addi- 
tion to using some of these lines to 


handle more data-bits from the com- 
puter, some of these lines could strobe 
the Transmit Buffer Register Load pin 
(TBRL) of the UART, to return data to 
the computer through the serial port. 
Note that this is saying that the rela- 
tively fast strobe on LPT1 requests the 
unit to send selected data on the serial 
line to be read by COM1. 


Applications 


Finally let us look briefly at a couple of 
applications which use the input/output 
facilities of the computer bus with ADC 
and DACs to simplify laboratory experi- 
ments, 


The Diode Characteristic. A silicon 
diode has a current against voltage 
characteristic curve as shown in Figure 
4, This might be compared to the 
current voltage curve for a simple re- 
sistance, which Ohm’s law (remem- 
ber?) says is a straight line. The detailed 
shape of the diode curve can be inves- 
tigated using these techniques. 


The program in Figure 5 assumes an 
8-bit DAC giving voltages in the 
range 0 to 10 volts, and an 8-bit ADC 
capable of reading voltages in the 
same range. The array volts [256] 
has values of the voltage across the 
diode, while the array cur- 
rent [256] has corresponding val- 
ues of the differences of the two 
measured voltages, which is propor- 
tional to the current through the re- 
sistance (which is of course equal to 
the current through the diode). These 
arrays therefore contain all the infor- 
mation necessary to plot the diode 
characteristic on the computer 
screen. Once the program is running, 
it isa simple task to test many diodes. 


/* Take data for a decay curve */ 
/* (capacitor decaying through */ 
/* a resistance) Ly) 
/* Use the PC30B circuit card */ 
#include <stdio.h> 
#define base  0x700 
define dac  base+20 
define addatl base /* 
*/ 
#define 
*/. 
#define 
#define 
+/ 
#define 
#define 
#define 
define 


low byte of adc 
addath base+1 /* high byte of adc 


addsr 
adcer 


addath /* & status reg */ 
base+2 /* adc control reg 


admde base+3 /* adc mode reg */ 

prescaler base+4 /* timer regs */ 

divider  base+5 

tmrctrl  base+7 

int readhardade (int) ; 

main() 

{ int data; 
/* configure adc ports */ 
outporth(admde, 0x92) ; 
/*channel 0, software strobes */ 
outportb(adcer, 2); 
outportb(tmrctrl, 0x34) ; 
outporth(tmretr1, 0x74) ; 


/* Strobe frequency 20KHz */ 
outporth(prescaler, 20); 
outporth(prescaler, 
outporth (divider ,5); 

outporth (divider, 0); 

/* Generate voltage step */ 
outporth(dac,0); delay (100); 
outporth(dac, 2000) ; 

/* select hardware strobes from timer */ 
outporth(adcer 0); 

/* decaying voltage */ 

for (i=0;i<256;i++) 

volts{i} = readhardade(); 
/* select software strobes */ 
outportb(adcer, 2); 
/* display linear-linear graph */ 
/* display log-linear graph */ 
1 


} 

int readhardade(int chan) 

{ /*wait for ‘DONE’ */ 
while (!(inportb(addsr) & 0x40)); 
/* return data */ 
return (inport(addatl) & 4095); 

} 


Figure © - Take data from a decay curve 
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If the curves for a transistor are re- 
quired, then the program is a little 
more elaborate but the same principles 
hold, and the gain in using the com- 
puter program, rather than doing the 
job manually, is considerable. 


R-C Decay. When a capacitor is al- 
lowed to discharge through a resis- 
tance, the rate of fall of the voltage 
across the capacitor follows an expo- 
nential curve. The general shape can 
be shown easily on an oscilloscope, 
but detailed and accurate measure- 
ments of the curve require a different 
approach. 


The program in Figure 6 generates a 
sharp drop in voltage applied to the 
resistance, then uses hardware strobes 
from a timer to make regular well- 
timed measurements of the voltage. 
across the capacitor. The array 
capvolts [500] has the basic meas- 
urements, which can be plotted on the 
screen to show the exponential curve. 
But it is also easy to plot the logarithm 
of the voltage, suitably scaled, to ob- 
serve the hoped-for straight line which 
will confirm the true exponential char- 
acter of the decay. Care must be taken 
to avoid putting the computer in a 
position where it tries to take the loga- 
rithm of zero. 


Conclusions 


When interfacing, the best method has 
to be selected in terms of the require- 
ments of the job. Speed and flexibility 
are clearly very important considera- 
tions. The diode characteristic used the 
bus interface, but a slower interface 
would have been equally satisfactory, 
since there are no strong time con- 
straints. The R-C decay has to be ob- 
served at a speed which depends on 
the decay time so that sufficient meas- 
urements can be made. 


EXE) 


Alastair Macleod is a senior lecturer in 
the Department of Physics and Astron- 
omy at the University of Glasgow. His 
PhD was in nuclear structure physics, 
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The PC30B circuit card was purchased 
from Flight Electronics in Southamp- 
ton (0703 437722), priced £389. 
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Serial Communications 


Introduction to Serial 
Communications 


Confused by baud rates, handshaking and stop bits? John Davies presents a 
Plain English Guide to the different standards used for serial communications. 


The basics of serial communication are 
very simple. A transmitter converts the 
bytes of information to be sent into a 
series of bits. These are then transmit- 
ted at a fixed rate and format to a 
receiver. The receiver, knowing the 
rate and format, can then reassemble 
the original data. 


In so-called ‘asynchronous’ serial 
communications, several other bits 
are sent in addition to the actual data 
(which is generally a single charac- 
ter). First, before the body of the data 
is sent, there is a start bit to indicate 
that the data transmission is starting. 
Second, after the data has been sent, 
an optional parity bit may be sent to 
aid error detection and correction. Fi- 
nally one or two stop bits are sent 
which indicate that the transmission of 
that byte is complete. 


Within this relatively simple protocol 
there is plenty of room for error. The 
transmitter and receiver must be op- 
erating at the same data rate. The 
format of the data (number of data 
bits, whether a parity bit is required, 
number of stop bits etc) must be the 
same. Finally the method of hand- 
shaking, if any, must be agreed upon. 


In addition to these requirements, the 
transmission standard used by both 
transmitter and receiver must be com- 
patible. While descriptions of the 
transmission rate and format are 
widely available, specifications of the 
various transmission standards used 
are not so common. The next part of 
this article will therefore look in more 
detail at the various serial communica- 
tion standards in use and concentrate 
on the most common standard - RS232. 


Transmission Standards 


Most serial communication systems op- 
erate via some sort of recognised trans- 
mission standard. Usually the transmit 
and receive data lines are taken from a 
computer through the appropriate inter- 
face chips over a length of cable to a 
second computer. The voltage levels 
used along the inter-connecting cable 
are usually very different from those 
used inside the computer. 


Before discussing the various transmis- 
sion standards in any detail, the question 
of why they are needed must be ad- 
dressed. You might think it would be 
simpler and easier just to take the raw 
logic signals from one computer to the 


Pin no Signal Notes 

1 Earth 

2 TXD Transmit data ( from DTE to DCE ) 
3 RXD Receive data ( from DCE to DTE ) 
4 RTS Request to send ( to DCE ) 

5 CTs Clear to send ( to DTE ) 

6 DSR Data set ready ( to DTE ) 

7 GND Signal ground 

8 DCD Data carrier detect ( to DTE ) 

20 DTR Data terminal ready ( to DCE ) 


Figure 1 - RS232 Pin Connections 
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next without any changes at all. This 
type of approach could work, but has 
great disadvantages. 


First, the voltage levels which are logic 
‘l’ and ‘0’ to one computer may not be 
the same thing at all to another com- 
puter. In most cases the voltage levels 
would be the same, but there could be 
sufficient difference to cause problems. 


Second, the logic levels within a normal 
computer do not have enough noise 
immunity for reliable communication 
over reasonable distances and speeds. 
‘Noise immunity’ means the amount of 
unwanted signal or noise introduced 
onto the signal lines. For example, mains 
hum, transients due to switching of large 
electrical loads or indeed other signal 
cables in the vicinity. 


Finally, most of the chips used to im- 
plement the various standards offer 
some means of protection against ac- 
cidental damage. For example a com- 
mon mistake with this type of 
communication is to connect two trans- 
mitters together instead of a transmitter 
to a receiver. This presents no problems 
to the average driver chip but could 
cause severe problems if the signal was 
connected directly into a computer. 


The list of standards described below 
is by no means exhaustive but they are 
the most common standards used. 
More standards exist but they are 
either not in common use or are a 
derivation of these standards. 


RS232 


This is by far the most common stand- 
ard. It is used for just about everything 


Communications for 
Windows and DOS 


A powerful C library plus a Windows toolkit for programming 
asynchronous communications—from Greenleaf 
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Greenleaf CommLib™ 


4 New PortOpenMSWindows() 
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Windows. 
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Brett Venson, Professional Software 
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© Greenleaf CommLib is the smoothest toolkit 
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Larry Dalton 


Greenleaf 
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Greenleaf Communications Products 


Greenleaf CommLib v4.0 £239.95 
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NEW: PowerComm. for 


Windows 
Extended Windows Toolkit 


4 DLLimplementation of CommLib 
4.0 PortOpenGreenleaf() with related 
Level 1 functions, all Level 2 
functions including file transfer, 
modem control, handshaking, etc.) 

4 VxD (Virtual Device Driver) 
implementation of CommLib 4.0 
drivers. 


Q Faster baud rates and throughput 
made possible by "native" 32-bit, 
Ring-0 implementation (VxD) for 
both Windows and DOS applications 
in any mix. 

Q Native Windows 3.1 implementation 
of CommLib 4.0 communications. 


Q Supports unlimited number of ports 
for Windows and DOS applications 
under Windows 3.1—simultaneous 
transfers using Windows and/or 
DOS applications. 


Q All protocols in CommLib 4.0 
available in DLL. 


Q Drives all non-intelligent multi-port 
boards supported by CommLib 4.0. 


Q All CommLib Level 2 functions 
available, plus all Greenleaf driver 
Level 1 functions available in DLL. 


Q Supports 386 Enhanced and 
Standard modes of Windows 3.1. 


Q Memory model and language 
independent dynamic link library 
technology takes the load out of 
your executable—shared libraries 
allow more programs to run in same 
computer. 


Q No royalties for redistribution. 
Q FREE support. 


Q Installation program to aid in 
configuration and startup. 


Requires CommLib 4.0. 


Official UK Product 


Citadel Software Ltd is the official European agent for 
Greenleaf products. We provide software, telephone 
support and product upgrades. Dealer enquiries are 
welcome. 


from connecting personal computers 
to peripherals (such as printers or plot- 
ters) to connecting terminals to main- 
frame computers. The full name is the 
RS-232D EIA standard (of January 
1987) and is also known as the CCITT 
V24 or V28 standard. 


The standard defines two types of 
equipment, namely Data Terminal 
Equipment (or ‘DTE’) and Data Com- 
munications Equipment (‘DCE’). DTE 
equipment is usually a computer while 
DCE equipment is usually a device 
such as a modem. 


A 25 way D-type connector is usually 
used for an RS232 port (pin connec- 
tions are as shown in Figure 1). The 
standard states that a DTE uses a male 
connector and DCE a female connec- 
tor. However, this part of the standard 
is largely ignored and the type of con- 
nector should not be used as a guide 
to the type of equipment. 


The voltage levels of an RS232 signal 
are as follows: 


@ A voltage between -3V and -15V 
represents a logic ‘1’ 


@ A voltage between +3V and +15V 
represents a logic ‘0’ 


The fastest data rate used on RS232 is 
generally 19,200 (bits per second). 
Faster transfer is possible, but gener- 
ally needs some form of data error 
detection and correction protocol 
within the computer software to cope 
with the inevitable errors which will 
occur at faster rates. 


RS232 can generally be used on any 
type of cable, but for fast data rates 
shielded cable (cable protected by an 
earthed screen along its length) is best. 


RS423 


RS423 is very similar to RS232 in its 
general operation. The voltage levels 
are slightly different: 


@ A voltage between -4V and -6V rep- 
resents a logic ‘1’ 


@ A voltage between +4V and +6V 
represents a logic ‘0’ 


RS423 is also more fussy about the cable 
which is used. The characteristic imped- 
ance of the cable (the impedance which 
the driver chips operate into) has to be 
greater than 450 Ohms. Although this 
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restricts the cable that can be used, it is 
possible to operate at data rates up to 
100,000 bps (or 100 kbps). 


There is no standard connector for 
RS423, but the data and signal lines 
and their functions are generally the 
same as those available for RS232. 


RS422 


RS422 is very similar in voltage levels 
to RS423 but with one important dif- 
ference. Instead of using one line to 
carry one signal (eg Rx, CTS) RS422 
uses two lines for each signal. This 
means that the noise immunity of each 
signal is greatly increased, as the volt- 
age level of each line can be measured 
relative to a reference which is closely 
coupled to that line. Any noise pulses 
on the line are therefore induced onto 
both the signal and the reference line 
equally and thus (we hope) cancelled 
out. This arrangement is called a ‘bal- 
anced pair’ of lines or ‘differential signal’ 
lines since the voltage level is not an 
absolute value as in RS232 but the dif- 
ference between the voltages on two 
lines. 


This change may not seem to be very 
great, but it does give a phenomenal 
increase in performance. Using line 
impedances down to 50 Ohms, it is 
possible to operate at data rates of 10 
Mbps (or 10 million bits per second). 
Alternatively, running at lower speeds, 
a great increase in noise immunity can 
be achieved. This is especially impor- 
tant if the communication is, for exam- 
ple, between a computer and a robot 
in an electrically noisy environment 
such as a car production line. 


Obviously RS422 requires twice as 
many (expensive) wires connecting 
the two ends together, so it is usually 
used only in special applications. As 
with RS423, there is no commonly 
used connector, but the same data and 
signal lines are available. 


RS485 


RS485 is electrically very similar to 
RS422, in that it uses differential signals 
and similar voltage levels. But it differs 
in one major respect: it is strictly a 
half-duplex link with no handshaking. 
At first sight this may seem a rather 
strange and somewhat restrictive pro- 
tocol but it has one main application - 
networks. RS485 forms the bottom (or 
physical) layer to many network appli- 
cations, for example, ARCnet, which is 


Serial Communications 


used extensively in industrial control 
applications. 


The actual RS485 interface chip will 
have transmit and receive signals to the 
computer, but will also have an addi- 
tional signal which indicates in which 
direction, transmit or receive, the inter- 
face should be operating. 


To ensure that only one device on the 
network is transmitting at any one time 
a special protocol is needed. This type 
of protocol is called ‘token passing’. 
This protocol, as the name suggests, 
involves passing a software ‘token’ 
around all the devices on the network 
from one to another. A particular de- 
vice may only transmit when it has 
possession of the token - at all other 
times it can only receive. 


To achieve this protocol each device 
on the network must have an unique 
address such that the token may be 
passed to it and that it can pass the 
token to the next address. Usually (but 
not always) the token is passed from 
one address to the next highest ad- 
dress and so on. Special cases must 
exist for when a new device is added 
to the network or when a device is 
removed from the network when it has 
the token, 


There is no commonly used connector 
for RS485, and the possible data rates 
are slightly slower than RS422 at 
around 2 Mbps. 


Current Loop 


All the standards described so far have 
been ‘voltage’ based standards: the 
logical ‘1’ and ‘0’ from the computer 
have been converted into two different 
voltage levels. There is however an- 
other method of representing the 1s 
and 0s, namely by the presence or 
absence of an electrical current flow. 
Because two wires are now needed for 
each signal, one to take the current out 


Side ‘A’ Side ’B’ 
pinpin 
2 3 
3 2 
4 ) 
5 4 
6 20 
iL Me 
20 6 
Note: pins 6 and 8 of each side © 
should also be connected together 


Figure 2 - Null Modem Cable 
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Protect Your Code, Your Projects, and Your Reputation 
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L | 


systems to be built with absolute repeatability. 
This increases productivity, but more importantly, 
entirely eliminates a common source of errors. 
PVCS Configuration Builder can now embed 
“footprints” of vital historic information into 
compiled objects and can act conditionally on 
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PVCS Production Gateway synchronizes the 
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LAN environment. 


PVCS Developer’s Toolkit delivers full PVCS 
functionality to your development environment 
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or Presentation Manager) to access the wealth of 
project information managed by PVCS. You can use 
predefined queries or build your own. PVCS 
Reporter queries can span multiple projects in 
distributed architectures to select, merge, sort, 
display and print exactly what you need. 


PVCS is the undisputed leader in Configuration 
Management for LANs. It operates seamlessly 
across MS-DOS, OS/2, VMS, and a host of 


Unix environments. 


The PVCS Series is so 
accommodating that it 
snaps right into existing 
projects. You don’t 
have to wait until you 
start a new project to 
implement it. More than 
a few of our customers 
have purchased PVCS to 
salvage projects that 
were dissolving into 
chaos... and they've been 
successful. Cure your 
biggest headaches 
before they happen. 


Call now for a FREE copy 
of “Cost Justifying 
Software Configuration 
Management”. 


Phone or fax for details of the PVCS Services. Tel 071 625 5255 Fax 071 624 9404 
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to the destination and one to bring it 
back, this type of arrangement is called 
a current loop. Current loops can run 
on virtually any current, but the most 
common values are 5 mA or 20 mA. 


In order to avoid earthing problems, 
the current loop is usually passed 
through an opto-isolator at the desti- 
nation. This device converts the cur- 
rent to a light beam and back to a 
current within a single chip to give 
electrical isolation. Because of this iso- 
lation it is possible to route the signal 
to more than one destination. This type 
of arrangement is very useful where 
there is a need for a ‘master’ device to 
transmit to and control several ‘slave’ 
devices and no return information is 
expected. 


There is no common connector used 
for this standard and usually the com- 
munication is simplex in nature. 


A widely used application of the cur- 
rent loop method is the Musical Instru- 
ments Digital Interface (MIDI) 
standard. The MIDI standard uses a 5 
mA current loop running at 32,500 bps. 
The normal connector used for MIDI 
is a 5 pin DIN type. 


That concludes the brief look at the 
various communication standards 
available. We shall now look at some 
of the common problems associated 
with the use of the most popular stand- 
ard - RS232, 


RS232 Troubleshooting 


There are three main problems with 
communication with RS232: 


1. Correct connection of the transmit 
and receive lines. 

2. Correct operation of any 
handshaking 

3. Correct link parameters (data rate, 
parity etc.) 


Before discussing these problems in 
detail it is worth considering what 
diagnostic equipment is necessary. 
There is quite a variety of instruments, 
and even the simplest will make RS232 
troubleshooting a lot easier than the 
‘plug it in and jiggle it’ approach often 
favoured by software types. 


The simplest of these is a ‘breakout 
box’ which can be plugged into the 
RS232 link and the various lines routed 
via jumpers, used to connect the link 
as required. The better types of break- 
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out boxes are battery powered and 
have LEDs to indicate the state of each 
line. By using the battery it is possible 
to force any or several lines into 
known states. This is very useful for 
sorting out hardware handshaking 
problems. 


At the other end of the scale is a serial 
link protocol analyser. This is typically 
a piece of equipment which is also 
plugged into the serial link and has a 
screen which is used to set up the link 
parameters and is also used to display 
the data passing along the link. The 
states of the various control lines can 
also be displayed. Serial link analysers 
are considerably more expensive than 
simple breakout boxes, and their ca- 
pabilities vary considerably. The better 
types have features such as automatic 
data rate setting which analyses the 
data lines and sets the data rate. Basi- 
cally you get what you pay for. This 
type of equipment is usually more 
useful for sorting out communication 
protocols rather than simple interfac- 
ing problems. 


Let’s now deal with the common prob- 
lems in turn, 


Tx and Rx Lines 


As mentioned previously, in theory a 
DTE should be connected to a DCE 
and thus pin 2 of the transmitter 
connector should be connected to 
pin 2 of the receiver and the same 
with pin 3. However, as was also 
mentioned, this standard is widely 
ignored. It may be necessary to cross 
over the lines between pins 2 of each 
end and pins 3 of each end. This is 
the case when connecting the serial 
ports of two PCs. 


It is usually possible to determine 
which pin is the transmit line by 
connecting a breakout box to the line 
and transmitting data from each end 
in turn. The LEDs which flash will 
then indicate which pin is being 
used. 


Handshaking 


If possible, turn off any handshaking 
for the initial tests. This may cause the 
loss of data - but is much easier to get 
started. 


The simplest type of handshaking uses 
the RTS output from the receiver con- 
nected back to the CTS line of the 
transmitter. To override this handshak- 


Communications 


ing connect the CTS line to an ‘active’ 
line - much easier if a battery pow- 
ered breakout box is used. If this 
does not work then try connecting 
the DSR line at the transmitter to an 
active line. 


A common cable configuration used 
is called a ‘null modem’ cable and the 
connections are shown in Figure 2. 


Link Parameters 


The link parameters are usually set be 
the software in the computers at each 
end. These parameters may be set by 
some interactive software which the 
user can access, or perhaps by using 
switches. The user manual for the 
computer or peripheral should give 
full details. 


If there is a VDU or such like at the 
receiving end which is displaying a 
series of ‘foreign’ characters then it is 
likely that the data rate is incorrect. If 
the data looks correct with the occa- 
sional character incorrect then it could 
be an incorrect number of data bits or 
incorrect parity. 


Stop bits do not usually give problems, 
although they can cause difficulties if 
the transmitter is sending one stop bit 
and the receiver is expecting two. The 
reverse situation, where the transmitter 
sends two and the receiver expects 
one, will not cause any problems as 
the second stop bit will seem to be the 
same as the idle state. 


Further Reading 


There are a number of books about 
communication and a few about RS232 
communications in particular. Many of 
these books are very expensive and 
the reader is advised to check that they 
are really of use before buying. One 
book however can be thoroughly rec- 
ommended, this is the Data Commu- 
nications book in the ‘Newnes Pocket 
Book’ series. As the name suggests it 
is a small book but it is packed full of 
information about all aspects of data 
communications. There is not much 
descriptive text, but it is a very useful 
reference book and costs under £10. 
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John Davies has worked in both real time 
hardware and software design environ- 
ments as an engineer and manager. 


As an applications developer or business PC user looking for a 
way forward in relational database management systems for 


Windows, may we point you in the right direction . . . 


A visual development environment for Microsoft 
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Visual C++ 


Now you see me 


Less than a year after the release of C 7.0, Microsoft is launching a new C++ product. 
A late beta crashed down upon Will Watts’ desk. 


At a massive Windows NT conference 
in July last year, graced by the 
presence of Bill Gates himself, atten- 
dees were invited to submit written 
questions to the great man on specially 
prepared cards; it was promised that 
Gates would answer a choice few after 
his keynote speech. Several thousand 
cards were duly filled out and handed 
in. One cheeky offering that he picked 
out to answer went something like 
this: ‘Why haven't you got a good C++ 
compiler, like Borland’s?’ 


An enigmatic smile passed over the 
Leader’s youthful features. ‘We’re 
working on something, which I think 
you will like. Wait and see.’ And he 
passed on to a less taxing poser: why 
he wasn’t Ross Perot’s running mate. 


Microsoft Visual C++ (MVC) is the pro- 
duct which Gates promised. MVC re- 
places both QuickC for Windows and 
Microsoft C/C++ 7.0, and is available 
in Standard and Professional Editions; 
the Standard Edition omits the Win- 


dows 3.1 SDK, CodeView, the profiler, 
the optimising compiler and, the 
ability to develop MS-DOS applica- 
tions. This article is based on a me- 
dium-hasty scramble through a late 
beta and concentrates on the ‘pretty’ 
parts; we will be back for detailed, 
hard-headed dissections of the details 
in future months. 


Starting up 


MVC’s installation program expands 
and empties the contents of twenty- 
one high-density 3.5" diskettes. If you 
want 5.25", you must contact Microsoft 
specially, as apparently it is no longer 
worth the company’s while to supply 
this format. A full installation, includ- 
ing all the examples, utilities and mem- 
ory models you will never need unless 
you don’t install them, will cost around 
50 MB of hard disk and the wrong end 
of an hour in time. The installation 
program is cute “Now would be a 
great time to fill out your registration 
card’), but repeated exposure to it, 


‘ompiling resources... 
fompi ling... 
s\afe\addi\stdafx cpp 


vompi ling... 
yafe\addrNaddr.epp 

:Nafo\addr\nainfm.cpp 
s\nfc\addr\addrdoc .¢pp 


CL returned error code 2,| 


DDR.EXE - 2 error(s), 0 CMainFrome 


© cviow 
CScrollView 
CEditView 

CControlBar 

CStatusBar 
ToolBar 
CDielogBar 

© csplitterWnd 


CAddrDoc* pDoc » GetDocument() + 


TODO: add draw code here 


ProparePrinting (CPrintInfo 
default preparation 


roturn DoPreparePrinting(pInfo) : 


oid CAddrViow: :OnBoginPrinting (CDC “*pDC*/ 


oid CAddrViow: :OnEndPrinting(CDC# “*pic*”. ¢ 


v¢ TODO: add cleanup efter printing 


Figure 1 - Visual WorkBench 
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dictated by a sequence of hardware 
failures, had me thinking now would 
be a great time to put in an expenses 
request for a CD-ROM drive, as MS is 
offering the whole lot on a single 
CD-ROM. 


Now let us have one second’s silence 
for the demise of Programmer's Work- 
Bench. All right, half a second. Its 
Windows-hosted replacement, Visual 
WorkBench, at last brings Microsoft C 
up to the Borland standard of ease of 
use. Figure 1 pictures Visual Work- 
Bench in action. 


For a start, you get an MDI text editor, 
with colour syntax highlighting, undo- 
redo, the remembering of recently op- 
ened files and post-compilation error 
chasing. Brief fans should note that 
there is no macro language. 


The browser, operating on a giant 
database created after linking, lets you 
view class hierarchies and call graphs, 
and also navigate around definitions 
and references to any symbol in the 
project. As you can see from the pic- 
ture, the hierarchies are displayed in 
an outliner fashion, like directories in 
File Manager. This had me puzzled for 
a bit - how could the browser cope 
with multiple inheritance? The answer 
is: it cheats. You select one class as a 
starting point, then choose between a 
derived class graph and a base class 
graph. The derived class graph is the 
‘normal’ class hierarchy, with the base 
on the left and derivations on the right. 
The browser simply ignores extra par- 
ents of multiply-inherited children - all 
classes appear to be singly inherited. 
Switch to the ‘base class’ graph and the 
display is ‘upside down’: the selected 
class is on the left, its parent(s) in the 
next column to the right, and so on. I 
foamed about this when I first dis- 
covered it, because it means it is never 
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The Industry’s 
Choice. 


Autodesk, Robert Wenig, MaRaeer AutoCAD for Windows: 
“At Autodesk, we're using WATCOM C/386 in the development 
of strategic new products since it gives us a competitive edge 
through early access to new technologies. We also highly 
recommend WATCOM C/386 to third party AutoCAD add-on 
(ADS and ADI) developers.” ‘ 


Fox Software, David Fulton, President: ‘FoxPro 2.0 itself is 
written in WATCOM C, and takes advantage of its many superior 
features, Optimizing for either speed or compactness is not 
uncommon, but to accomplish both was quite remarkable.” 


GO, Robert Carr Vice President of Software: “After looking at the 
32-bit Intel 80x86 tools available in the industry, WATCOM C was 
the best choice. Key factors in our decision were performance, 
functionality, reliability and technical support.” 


IBM, John Soyring, Director of OS/2 Software Developer Programs: 
“IBM and WATCOM are working together closely to integrate these 
compilers with the OS/2 2.0 Programmer's Workbench.” 


Lotus, David Reed, Chief Scientist and Vice President, Pen-Based 
Applications: “In new product development we're working with 
WATCOM C because of superior code optimization, responsive 
support, and timely delivery of technologies important to us like 
p-code and support for GO Corp’s. PenPoint.” 


Novell, Nancy Woodward, VP and G.M,, Development Products: 
“We searched the industry for the best 386 C compiler technology 
to incorporate with our developer toolkits. Our choice was 
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possible to obtain a complete view of 
a complex hierarchy. But when I went 
back to Borland’s system for compari- 
son, I noticed 1) that such diagrams 
can be a bit of a mare’s nest and 2) 
they take ages to draw, I switched my 
browsing allegiances. 


As with PWB, programming is centred 
around the ‘project’ which consists of 
two files: an ASCII .MAK - which can 
be used to rebuild from the command 
line - and a binary .WSP which main- 
tains preferences such as the position 


of your window. Compilation options | 


are set up via a clever dialog which 
avoids the need to hunt up and down 
menus. Compiling and making is 
achieved by launching a separate 
pseudo-DOS task to run command line 
tools, and piping their output to a 
special MDI window (on the left in my 
figure). Not as fast as Borland’s DLL- 
based system, but compilation does 
run in the background, so you can 
continue working on the project if you 
can put up with leaden response times. 
Mr Richard Pearce of CADS in Dorset 
asked me if QuickC’s super-fast syn- 
tax-check has been re-introduced. The 
answer is ‘No’. 


Before getting on to the other tools, I 
must also mention the integrated Win- 
dows debugger. Unlike CodeView, 
this is fairly easy to use and, unlike 
pretty well all other debuggers I have 
ever tested under Windows, it didn’t 
fall over inexplicably within 20 
minutes of being fired up. Since tracing 
takes place in editor windows, you can 
make fixes to the code as you go - it’s 
just like the debugger in Borland’s text 


mode IDEs. Another neat feature 
which I particularly appreciated was a 
‘step out of button on the bar, for 
escaping from low-level functions that 
you have wandered into by mistake. 


Studio line 

AppStudio is Microsoft’s answer to 
Borland’s Resource Workshop: yet an- 
other MDI application, with the capa- 
bility of handling all the standard 
Windows resources: accelerators, bit- 
maps, cursors, dialogs, icons menus and 
strings. AppStudio has its own icon in 
the MVC Program Manager group, but 
the best way to fire it up is by opening 
a .RC file from within Visual Work- 
Bench, as this way it gets passed extra 
information by the project which en- 
ables it to work out which header files 
to update without asking. AppStudio is 
illustrated in Figure 2, editing a dialog 
box. I'll concentrate on this, because it 
shows off some of AppStudio’s best bits, 
but you can take it that all the other stuff 
is smooth and very usable. 


The large free-floating window at the 
bottom is the Properties window - this 
lets you edit the attributes of the con- 
trol currently selected. The nice thing 
about it is that you don’t have to bring 
up a dialog to do it - by pressing the 
drawing pin icon in its left hand cor- 
ner, you can have it remain on display 
all the time, its contents changing to 
reflect the control currently selected. 


Controls are added by dragging and 
dropping from the ‘chocolate bar’ win- 
dow, shown at the top right of the 
picture. If something about this setup 


App Studio - ADDR.RC 


Figure 2 - AppStudio, with Visual Basic controls 
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reminds you of Visual Basic, well, so 
it should. As well as allowing you to 
import standard (Microsoft format) 
custom controls onto the button bar, 
AppStudio lets you add .VBX Visual 
Basic controls (but, needless to say, 
not Borland-format controls found in 
BWCC.DLL). The graph control in the 
dialog is in fact an instance of Bits Per 
Second’s famous Graphics Server. 


Before I explain how these compo- 
nents get integrated into a C++ appli- 
cation, I must backtrack to two more 
tools: the Wizards. 


Two Wizards 


‘Wizard’ is a Microsoft term familiar to 
Excel users; for the benefit of fellow 
non-Excel users, it seems to mean 
something like ‘application generator 
type program’. 


The less interesting of the two wizards 
is App Wizard, which will generate the 
files for a skeleton MFC-based file-edi- 
ting application - you get to write the 
bit that decides the type of file 
handled: text, image, sound, database 
or whatever. App Wizard is typically 
fired up from Visual WorkBench’s 
‘Project’ menu. You give the project a 
name, optionally creating a new direc- 
tory for it to live in - a thoughtful touch, 
that - and select which features you 
wish to include in the application: 
MDI, OLE, printing, toolbar, context 
sensitive help. AppWizard then gener- 
ates four pairs of class implementation 
and header files for the code, plus 
associated resource and make files. 
The four base classes used are [deriva- 
tions of] CFrameWnd, CWinApp, 
CDocument and CView - more of 
these anon. AppWizard inserts com- 
ments in the code along the lines of 
‘Put your bit in here’ and ‘Don’t meddle 
with this’, but it is a one-shot utility. 
Once you have generated the files, 
AppWizard can’t read them back in. 


But ClassWizard can. ClassWizard is a 
tool which allows you to bind Windows 
messages to their target member function- 
s. It knows about all your message-hand- 
ling classes in your project, and all the 
user interface objects that they contain, 
and it knows which messages you might 
want to process. Equipped with this 
knowledge, it lets the user add message- 
handler functions by a few clicks, create 
whole new classes for extra views such 
as dialogs, and add data members to 
classes which will automatically connect 
to input fields in dialog boxes. 


Put an end fo software piracy! 
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To show what ClassWizard can do for 
you, let’s consider dialog handling. 
Pre-MVC if you have a complex form, 
bristling with controls of various 
types, you knew that you were in for 
a fair amount of drudge coding just 
to get values in and out of the dialog 
- never mind clever stuff, such as 
input validation. In MVC you create 
a dialog in App Studio, bring up 
ClassWizard and 1) have it derive you 
a class from CDialog, add message 
handlers for your push buttons, 2) 
use it to add data members to the 
class, whose values will automat- 
ically be copied to and from the 
data-baring controls (eg input boxes) 
and 3) specify validation ranges for 
the contents. If you are using .VBX 
controls, it will do most of the extra 
work required to get these going too. 


A final note: if you later want to delete 
some stuff, ClassWizard will handle 
that too - it is not one of those tools 
that throws a fit if you so much as 
breath on the code that it has gener- 
ated. 


MFC 2.0 


MEC 1.0 left me with the feeling that 
Microsoft didn’t have its heart in C++, 
There was the messy business of the 
message-handling, which seemed to 
make it almost more of a fiddle to use 
C++ instead of C. This combined with 
the fact that the classes provided only 
the thinnest of layers over the API, 
especially compared to OWL or any of 
the other dozens of Application Frame- 
works around. 


MFC 2.0 certainly adds the depth. It 
bundles so much free functionality - 
for example, applications automat- 
ically know how to open files which 
have been dragged and dropped from 
File Manager - that I suspect ‘excess 


baggage’ will be the new general 
whinge. Other goodies include print- 
ing with previewing, tool/button bars, 
status lines and code to handle most 
of the work on the File menu. 


At the centre of MFC 2.0 lies the docu- 
ment/view structure. Figure 3 shows a 
schematic diagram of the framework 
hierarchy. Where OWL wants you to 
add most of your application’s func- 
tionality to the descendants of TWin- 
dow, MFC expects you to manage all 
the data in something derived from the 
cDocument, and display it using a 
derivative of CView. So in the example 
‘Scribble’ painting application in the 
Class Library User’s Guide, it is 
CScribDoc which stores all the 
mouse strokes, and knows how to load 
and save data to files; while CScrib- 
View contains the OnDraw member 
function which puts the document on 
the screen. This splitting of responsi- 
bility should help keep the design 
flexible and clear when writing, say, 
multi-document-type MDI applica- 
tions. I have not had enough experi- 
ence to have formed an opinion of 
how well it works. 


Other bits 


As usual, I’m running out of room, so 
must hurtle through some of the other 
features. The actual compiler, which 
bills itself as ‘C 8.0’ on the command 
line, is disappointingly only capable of 
generating 16-bit code. Microsoft says 
that a 32-bit version will be launched 
with NT, but there will be no bundled 
DOS Extender - you'll have to acquire 
tools now being created by Phar Lap 
to use it in the DOS environment. The 
precompiled header system has been 
revised to make it less of a pain to use 
- but it still seems a bit clumsy com- 
pared to the Borland approach. De- 
spite claims in the Microsoft literature 


CObject “] 
CCmd Target 
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Vv v Classes 
CWin App CDoc Template | [ CWind CDocument 
Vv v 
CFrameWnd CView | CDialiog 
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CYourApp CYourFrame CYourVw | CYourDig CYourDoc Classes 


Figure 3 - Schematic diagram of MFC 
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Visual C++ 
of lightning compilation speeds, the 
MAKES still felt sluggish - but we'll 
come back to this in a proper test. Also 
to be proved are optimisation tweaks 
including better smart linking and 386 
code generation. C++ support remains 
at cFront 2.1 level: templates and ex- 
ceptions are simulated by macros. 


The QuickWin Library - the thing 
which lets you kludge DOS programs 
to run in a Windows window - has 
been enhanced in a number of ways; 
in particular it now emulates GRAPH- 
ICS.LIB. 


The documentation was uniformly 
good, especially three volumes dealing 
with the class library. Online help 
seemed much more context sensitive 
and better indexed than before; I par- 
ticularly admired extra buttons in the 
help system which lets one display the 
class library hierarchy in a separate 
window. 


End Thoughts 


If you are the sort of person who thinks 
that programs are best written with an 
elderly copy of EMACS, and that a 
MAKE file is not worthy of the name 
unless every line had been chiselled 
out by hand, then MVC does not offer 
you much. Everybody else will love 
it: for the first time Microsoft has 
drawn ahead of Borland in the area 
of the programming environment. 


Another worry for both Borland and its 
users must be the enrichment of MFC. 
It would be quite perverse to start a 
C++ programming project with these 
tools and not use MFC: the integration 
is so tight. We know that Microsoft 
intends to make MFC the standard API 
for Windows; it now has published the 
technology to make this stick. OWL 
users like myself will wonder if they 
are becoming, as Jasper Carrot might 
put it, Betamax men. 


EXE) 


Microsoft Visual C++ has an RRP £335 
for the Professional Edition on CD- 
ROM or diskette, or £279 for the ‘tree 
saver’ version without printed docu- 
mentation. The Standard Edition is 
priced £139. There is a complex up- 
grade structure from previous versions 
- call 081 8938000 for details. There 
are no ‘competitive’ upgrades from ri- 
val C++ systems. The product should 
ship mid-March. 


ty Nu-Mepa 


TECHNOLOGIES INC 


ANOTHER DEBUGGING BREAKTHROUGH 


BOUNDS-CHECKER FOR WINDOWS! 


— — - 


The Power Of BOUNDS-CHECKER is now available for Windows 


NEW! BOUNDS-CHECKER for Windows is the only totally automatic BOUNDS-CHECKER for Windows 
ase bes Noe memory corruption, heap corruption and resource quickly & easily traps: 

Memory arid heap related corruption problems 
BOUNDS-CHECKER for Windows is an easy to use utility that automatically Library routine over-runs of strings, 
detects problems in your local heap, global heap, stack or data segment. It also arrays and structures 
tracks resource allocation / de-allocation, performs full parameter checking Attempting to free bad blocks 
(even when not using the debug kemel) and handles all Windows faults. In one NULL pointers the instant they are referenced 
step, you can quickly and easily flush out some of the most aggravating bugs that Resources that were not freed 
a Windows programmer is likely to encounter. (shows your actual source line that created the resource) 
Using BOUNDS-CHECKER for Windows is simple, there are no changes Errant parameters passed to API routines 
to be made to your source in any way, and no linking of code or macros into Processor Faults 
your executable. When a bug is found, BOUNDS-CHECKER for Windows 


pops up showing you the source code that caused the problem. Order Now! Only £149.00 plus VAT 


For even more debugging power at a great value you can order BOUNDS-CHECKER for Windows in one of our package 
bundles that include other Nu-Mega debugging tools: 


BOUNDS-CHECKER for DOS & BOUNDS-CHECKER for Windows £229.00 (plus VAT) 
BOUNDS-CHECKER & Soft-ICE (DOS or Windows versions) £379.00 (plus VAT) 
Get all 4 products (BOUNDS-CHECKER & Soft-ICE for DOS & Windows) £575.00 - SAVE £300.00 (plus VAT) 


We're making C/C** a Safe Language! 


e 
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Use 


Adding Plumbing to C++ 


An admirer of UNIX’s compound utilities, 
Declan Brennan decided to create a Borland C++ version. 


One of the aims of C++ is to encourage 
code reuse by employing object-ori- 
ented techniques. That remjnded me 
of an early example of code reuse - 
UNIX shell script. 


UNIX is normally supplied with hun- 
dreds of standard utility programs. By 
using shell scripts and pipes, these 
utilities can be combined in all sorts of 
creative ways. This makes it possible 
to achieve results quickly even if the 
implementation is somewhat ineffi- 
cient. For example, if one wants a 
report of word frequency in a docu- 
ment, this can be achieved with the 
pipeline in Figure 1. (The C++ version 
will be explained below.) 


Pipelines are read from left to right, 
and consist of a series of processes or 
tasks which pass information to one 
another. In this example, the t r utility 
first breaks up mydoc.txt into a list of 
words, This is passed to the second tr 
which converts the words to lower 
case. These are then sorted into alpha- 
betical order and passed to uniq 
which produces a list of words pre- 
ceded by the number of occurrences. 
This is then sorted into reverse nu- 
merical order so the most frequent 
words appear first. Finally pr takes the 
list and produces a columnar report 


which is stored in freq.txt. 


MS-DOS pretends to implement pipes 
by using temporary files. Thus each task 
has to finish completely before the next 
task starts reading its output file. In 
UNIX, all the tasks execute concurrently 
and the operating system maintains 
memory queues between tasks. I em- 
barked on an effort to get similar func- 
tionality under DOS using Borland C++. 


My basic approach was to define a C++ 
base class called Task, and to define 
the <, > and | operators for this class 
in order to achieve input and output 
redirection and piping. The < and > 
operators would open input and out- 
put files for a Task. The | operator 
would form a link between two Tasks 
with the address of the first class being 
stored in a Feeder pointer member of 
the second class. A pipeline would 
then result in the creation of a linked 
list of tasks and an Execute () func- 
tion could be used to start the Tasks 
passing information to one another. 


An Example Task 


The header for a sample derived class is 
shown in Figure 2, The Unig Task can 
be used to produce a list counting the 
repeats in its pre-sorted input. It can also 


The UNIX pipeline: 


tr “A=2)/" “la=z] | ssoxnt 
unig. <¢: || sorto-xn...| 


The C++ equivalent: 


SortNum (Sort: : REVERSE) 


> "freq.txt"); 


tr -cs "(A-Z)[a-z)" "(\012*]" < mydoc.txt | 


pr -4 -w78 -h "Word Frequency for mydoc" 


Execute( Tr (Tr::COMPLEMENT+Tr: : SQUEEZE, 
"A-Za-2","\n*") < "mydoc.txt" | 
Tr("A-Z2","a-z") | SortAlpha() 


Pr("Word Frequency in mydoc", 3) 


> freq.txt 


| Uniq(Uniq::COUNT) | 


Figure 1 - A UNIX pipeline to report on word frequency 
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class UniqImp; 


class Uniq:public Task 
( public: 
/* Available Flags */ 
enum { UNIQUE=1,REPEATS=2,COUNT=4 }; 
Uniq(int flags=UNIQUE+REPEATS) ; 
~Uniq(); 
void Body (void) + 
private: 
/* Pointer to implementation privates 
*/ 
Unigqimp *pi; 
Ae 


Figure 2 - Interface of the 
Uniq Task Class 


be used to produce a list of repeated 
lines or a list of unique lines depending 
on the flags passed to its constructor. 
Because Unig is inherited from Task, 
Unig objects can be used anywhere that 
expects a Task object, for example as 
one of the arguments of the | operator. 


I used enum to declare the various 
constants that are used (in any combi- 
nation) as the flags parameter in the 
Unig constructor. Annoyingly, const 
cannot be used to declare an initialised 
constant in a class declaration but 
enum is a good substitute that is in any 
case more compact. 


Apart from the constructor and the de- 
structor, the only other member function 
is Body (), which actually implements 
the utility’s functionality. This is true of 
most of the classes derived from Task. 
Finally, notice that there is a separate 
class to hold the implementation of 
Uniq, Only a pointer to this class is kept 
in the main Unig class. This is a trick 
that I picked up from this very magazine. 
At the cost of an extra pointer and the 
overhead of dereferencing to access im- 
plementation members, all implementa- 
tion details such as include files are kept 
concealed from the user. This means that 
the implementation can be changed in 
the future without requiring a recom- 
pilation of all programs using the class; 
thus depriving me of yet another excuse 
to break off for a coffee. 


J ? 


No Limits! 


Introducing Borland Pascal with Objects" 7.0 


BORLAND PASCAL 
WITH OBJECTS 


|D0S 


BORLAND PASCAL 
WITH OBJECTS 
BORLAND 
Break the 
—— 640K barrier 


Borland just blew away the limits to 
programmer productivity. Now you can 
break through the 640K barrier with. DOS 
Protected-mode (DPMI) applications that 
give you up to 16Mb for code and data. 
There’s even a DOS extender included, 


Cross-platform DLLs 
in Windows or DOS 


You get the full power of Object-Oriented 
Programming for creating full-blown 
Windows or DOS applications. Every 
DOS DLL that you create to run in 
protected mode is automatically binary- 
compatible with Windows. That means 
you can share and swap DLLs between 
Windows and DOS, and even link with 
DLLs written in C and C++, 


BORLAND 


Everything the professional 
needs in one box 


First we combined Turbo Pascal 
Professional and Turbo Pascal for Windows. 
Then we added hot new professional tools 
to create the most complete Pascal 
development system ever. Included are: 
ntegrated Development Environments 
for Windows and DOS 
Application Frameworks™ for Windows 
and DOS give you great-looking user 
interfaces with just a few lines of code. 
Break the 640K barrier with DPMI 
ObjectBrowser™ for Windows and DOS 
lets you see class relationships at a glance 
“astest compiler — 85,000 lines per minute 
Colour syntax highlighting helps you spot 
errors quickly 
Turbo Debugger,® Turbo Profiler," and 
Curbo Assembler® 

Resource Workshop and WinSight™ 


Get the most significant upgrade 
in Pascal history today! 


You'll be amazed at the power and 
productivity capacity built into this 
breakthrough new version of Pascal. Best of 
all, Borland has accomplished this without 
sacrificing the legendary ease of use and 
learning that has made Pascal from Borland 
the world’s most productive programming 
language. Get Borland Pascal with Objects 
7.0 today, and there will be no limit to your 
programming productivity. 


Software Craftsmanship 


Pricing and upgrade information 


Borland Pascal with Objects 7.0 is 
available at RRP of £299.95? 


Users of BASIC can upgrade for 
£129.95.° Users of any previous version 
of Pascal can upgrade for £99.95" 


For more information on 
Borland Pascal with Objects 7.0 
fill in the coupon, ring Borland 
FREE on 0800 212727 or see 
your local Borland Dealer. 


Please send me the FREE Borland Pascal 7.0 
Information package. Ref: [AS/9309/BP 


Which operating system do you use? 
O bos 0 Windows 


O Other 


Name 


Position 


Company 
Address 


Postcode Tel. 


Please return to: Borland International (UK) Ltd, 
FREEPOST, PO Box 9, Stroud, Glos., GL6 8BR. 
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Borland International (UK) Ltd, 8 Pavilions, Ruscombe Business Park, Twyford, Berkshire RG10 9NN_ Tel 0734 321150 


Copyright © 1992 Borland International, Inc. All rights reserved. All Borland product names are trademarks of Borland International, Inc. 


* All prices exclude VAT (and P&P where applicable) 


/*===| Implementation of Task: Uniq |===*/ 
include <string.h> 


#include “task. hpp" 
#include "uniq.hpp" 


/*--- Unig Implementation Class - 
class Uniqimp 
{ friend class Uniq; 
private: 
/* Copy of Flags passed 
to uniq constructor */ 
int Flags; 
int Count; /* Current no of repeats */ 
/* Previous Line */ 
char PrevLine(Task: :MAX_LINELEN]; 


/* Make an output line */ 
bool MakeLine(char *Line,char *Out~ 
Line) + 
Me 


/*---| Make an output line |-------- */ 
bool Uniqimp::MakeLine (char *Line, 
char *OutLine); 
( bool re=FALSE; 
if (Count>0) 


C++ In Use 
{ if (Flags & Unig: :COUNT) pi->Flags=Flags; 
{ sprintf (OutLine,"%4d %s", Count, strepy (pi->PrevLine, "") ; 
Prevbine) ; } 
/* Output each line preceded by 
number of occurrences */ /*---| Destructor for Uniq |------------ */ 


xe=TRUE; 
} 


else 


if ((Flags & Uniq::UNIQUE) && Count==1) 
{ strcpy(OutLine, PrevLine) ; 
re=TRUE; /* Output unique lines */ 


} 
else 


if ((Flags & Unig::REPEATS) && Count>1) 
{ strepy (OutLine, PrevLine) ; 
/* Output lines that are repeated */ 


Unig: :~Uniq() 
{ delete pi; 
) 


re=TRUE; 
) return; 
} } 
strepy (PrevLine, Line) ; else 
Count=1; pi->Count++; 
return re; ) 
) 
{ Puts (OutLine) ; 
/*---| Constructor for Unig |----------- +*/ pi->Count=0; 


Uniq: :Uniq(int Flags) ) 


{ pisnew UniqImp; 
pi->Count=0; 


} 


/*---| Body of Uniq |-- 
void Uniq: :Body (void) 
{ char Line {MAX_LINELEN], 
Out Line (MAX_LINELEN] ; 
while (Gets(Line)) 
{ if (stremp (Line, pi->PrevLine) !=0) 
{ if (pi->MakeLine (Line, OutLine) ) 
if (! Puts (OutLine)) 


if (pi->MakeLine("", OutLine) ) 


Figure 3 - Implementation of the Uniq Task Class 


The implementation of the Unig class 
appears in Figure 3. The basic func- 
tionality is implemented in the 
Body() member. This calls the 
Gets () member to read input lines 
and the Puts () member to write out- 
put lines. Gets () hides whether the 
Task is obtaining input from a file or 
from a preceding Task in the pipeline. 
Similarly, Puts () conceals whether 
output is to a succeeding Task or to 
a file. Concealing this information from 
Body() makes its implementation 
simpler. 


When Body() calls its Gets () 
member, and the queue from the 
preceding Task is empty, the 
Body () of the preceding Task will 
automatically be called to fill its out- 
put queue. Puts () returns TRUE as 
long as there is room for at least one 
more line in the Task’s output 
queue. When it returns FALSE, 
Body () must exit to allow the suc- 
ceeding task to empty this queue. 


In a conventional multi-processing 
system, each task has its own private 
stack to preserve its state when task 
switching takes place. In this object- 
based implementation, a Task’s state 
is maintained in the private’ members 
of that object. (Automatic variables lo- 
cal to Body () would not be main- 
tained between invocations, while 
statics would cause interference be- 
tween instances). Because Body () is 
likely to be carrying on from where it 
left off, for loops with initialisers are 
unlikely to be much use. Instead, loop 
counters are initialised in the Task’s 
constructor, and a while loop can be 
used to continue the iteration from 
where it finished last time. 
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Task 


Awk Echo Find Grep Grp Head 


Ls More 


LineCnt cFunc 
| Pr Rm | Sort Gs Uniq We 
SortNum || SortAlpha 
Figure 4 - The Task Class Hierarchy 
Task Description Parameters Flags 
Awk Pass each input line to Processor Function 
‘a processor function 
LineCnt Number each line of Input 
cFunc Filter function definitions Width 
from C or C++ input 
Echo Echo a message to output Message 
Find Output a recursive file Flags POSTDIR 
listing Root Path DIRONLY 
Search Spec. 
Grep Output all matching Search Pattern 
input lines 
Grp Output from a Group of List of Tasks 
Tasks one after another 
Head Output the first input lines Number of Lines 
Ls Output a directory listing Directory 
More Output all input lines 
pausing every screen full 
Pr Produce a columnar report Title 
Number of Columns 
Line Width 
Page Length 
Rm Remove files and directories Flags INTERACTIVE 
named in the input VERBOSE 
Sort Output sorted input lines Flags REVERSE 
SortNum Sort in numeric order Flags REVERSE 
SortAlpha Sort in alphabetic order Flags REVERSE 
Tr Translate input characters Flags COMPLEMENT 
Domain Set DELETE 
Range Set SQUEEZE 
Unig Output unique input lines Flags UNIQUE 
REPEATS 
COUNT 
We Word Count & other Flags CHARACTERS 
statistics WORDS 
LINES 


beeen eee indicates locations where the hierarchy can be extended 


(Each Task is further documented in its header file) 


Figure 5 - Table of Tasks 


i rary. 
 ¢: Creating tempora De 
swap file, please wait. 


How much longer can you afford to wait? 


Create Overlaid Programs-Fast. 
BLINKER"™, the world's first and 
fastest dynamic overlay linker, 
reduces your link time to seconds 
and reduces program memory 
requirements. Now you can use 
one linker for all your software 
projects. 


One Linker, Many Languages. 
BLINKER 2.0 links and automati- 
cally overlays DOS programs 
written in Microsoft?C, BASIC, 
Assembler, QuickBASIC”, 
Fortran, Pascal, Watcom" C, 
Zortech C++, Clipper’, FORCE® 
and in Borland’ C, C++, 
Assembler, and more. 


Save Time and Memory. 
BLINKER removes the need for 
overlay structures, simplifies 
program design and reduces 
memory requirements to save 
you time, effort and memory. 


Memory Swap Function. 
BLINKER is the ONLY linker to 
offer an integrated memory swap 
function, so you can run other 
large programs from within your 
program, with negligible memory 
overhead. 


Wynarnic Overlay Linker 


Don't Settle for Less. 


Other major features include full 
CodeView® support, use of 
EMS/XMS at program run-time, 
and enhanced execution speed 
of overlaid code. 


Time is Money. 

BLINKER offers all this in a frac- 
tion of the time it takes to link 
with your current overlay linker. 
You know time is money, and link 
time is no exception. 

To try our free demo re | 
on your own code 

and for more information 

contact our U.K. distributor: 


Call: +44-81-994-4842 
FAX: +44-81-994-3441 


QBS Software Ltd. 
10, Barley Mow Passage 


Free Demo 


London W4 4PH 

BLINKER is’ a 4 
available in a 
5.25" or 3.5" Seal 
diskette format 4 
Price £229 Blinkinc 


plus shipping & handling 


P.O Box 9 
Penarth, Sth Glam 
Gwent CF6 2XF 
U.K. 


© 1991 Blinkinc. Blinker is a traclemark of Assembler Software Manufacturers Inc 
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Some Tasks, for example Tr, operate 
on a character by character basis in- 
stead of line by line. Getch() and 
Putch() member functions are pro- 
vided to support this. An obvious ex- 
tension would be to provide similar 
functions to support the reading and 
writing of blocks. An even better de- 
sign (left as an exercise!) would be to 
allow access to C++ streams to handle 
the input and output from Task 
classes. 


The Task Hierarchy 


Unig is just one among many classes 
that can be derived from Task. The 
current class hierarchy is shown in 
Figure 4. This hierarchy can be ex- 
tended in three ways. Entirely new 
classes can be derived from Task 
with their own implementation of the 
Body () virtual method. Secondly, 
new Sorts can be defined by deriv- 
ing a new class from Sort and rede- 
fining the Order () virtual method. 
Finally, new line handlers can be 
defined by deriving a new class from 
Awk and redefining the Awkline () 
virtual method. 


C++ In Use 


class Task 

{ public: 
Task (); 
Task (const Task &t); 
virtual ~Task(); 
/* Establish a pipe to successor task */ 
Task operator | (Task t); 
/* Return pointer to original task */ 
Task * Original (void); 
UE Morac ii) 


/* Copy a Task */ 


) 


inline Task::Task(const Task &t) 
{ CopiedFrom=(Task *) 6t; 
} 


Task * Task: :Original (void) 
{ Task *pt=this; 
while (pt->CopiedFrom 
pt=pt->CopiedFrom; 
return pt; 
) 


Task Task::operator| (Task t) 

{ t.Original ()->Feeder=Original (); 
return *t.Original(); 

) 


Figure © - Discarded Implementation for the Task Class 


To make it easier to use these Tasks, 
I have named most of them after their 
UNIX equivalents. They are all listed 
with a brief description of their pur- 
pose in Figure 5. Unig is just one of 
the Tasks employed in the C++ ver- 
sion of the UNIX pipeline in Figure 1. 


The Task Class 


My ideas for the implementation of the 
Task class itself evolved as my knowl- 
edge of C++ improved. Initially I was 
going to have the | operator function 
accept Task* arguments. This would 
have meant complicating the pipeline 
expressions with either & or new opera- 
tors. It would also have required some 


system for deleting Tasks once the 
execution of the pipeline was complete. 


The initial implementation involved using 
Task type arguments for the | operator. 
By putting a diagnostic in the destructor 
for Task, I discovered that such Tasks 
were only destroyed after the entire state- 
ment was finished. However there was 
another complication. Task objects 
were copied when passed as arguments 
and returned from functions. To ensure 
that only original Tasks were placed in 
the pipeline linked list, it was necessary 
for a copied Task to keep a pointer to 
its original Task. An Original () 
member function could then be em- 
ployed to return a pointer to the original 


Task, Queue 

To provide a mechanism to 
allow the implementation 
of UNIX like pipelines in 
Ct under DOs. 


*/ 
finclude <stdio.h> 


enum { FALSE, TRUE }; 
typedef char bool; 


class Queue; 


class Task 
( public: 
enum { QBUF_LEN=1024, 
MAX_LINELEN=133 ); 
Task (); 
virtual ~Task(); 
/* Establish a pipe to successor task 


Task& operator | (Task& t); 

/* Redirect this tasks input: Set fin 
we 

Task& operator<(char *InFile); 

/* Redirect this tasks output: Set 
fout */ 

Task& operator>(char *OutFile); 

/* This function is always overriden in 

derived classes */ 

virtual void Body(void) = 0; 

/* Execute a pipeline */ 

friend void Execute (Task& t); 


protected: 
/* Get an input line */ 
bool Gets (char *Line) const; 
/* Produce an output line */ 
bool Puts(const char *Line); 
/* Get an input character */ 
int Getch(void) const; 
/* Produce an output character */ 
bool Putch(char ch); 
/* Pointer to the feeder task */ 
Task * Feeder; 


private: 
/* This task’s output queue */ 
Queue *TaskQ; 
/* Input file if no feeder task*/ 
FILE *Fin; 
/* Output file if no output queue */ 
FILE *Fout; 


| Implementation of the Task Class 
mf 


finclude <sys/types.h> 
include <sys/stat .h> 
finclude <fent1.h> 
f#include <io.h> 
finclude <string.h> 
finclude <stdlib.h> 
#include "task.hpp" 
/* Used to check for premature destruction 
of original Tasks before execution is 
complete */ 
static bool EndOfExec; 


{ TaskQ = new Queue (this, QBUF_LEN); 
Feeder=NULL; 
Fin=stdin; 
Fout=stdout ; 
EndOfExec=FALSE; 
) 


void Task::~Task() 
{ if (! EndOfExec) 
{ printf("Error: Original object de- 
stroyed\ 
before end of execution. \n"); 
abort (); 
} 
if (Pout !=stdout) 
fclose(Fout) ; 
if (Fin!=stdin) 
fclose (Fin); 
if (TaskQ 
delete 


} 


Task& Task: :operator 

( t.Feeder=this; 
return ty 

) 


(Taské t) 


Tasks Task::operator> (char *Outfile 
{ Fout= fopen(Outfile,"w"); 

return *this; 
) 


Task& Task::operator< (char *Infile 
( Fin= fopen(Infile,"r"); 
return *this; 


) 


void Execute (Taské t) 
{ delete t.TaskQ; 
/* We don’t need a queue here 
because this is the sink task */ 
t. TaskQ=NULL; 
t.Body ()7 
EndOfExec=TRUE; 
) 


bool Task::Gets(char *Line) const 
{ if (Feeder==NULL: 
/* Get from Input File */ 
return fgets (Line, MAX_LIN- 
ELEN, Fin) !=NULL; 
else 
/* Get from Feeder Task’s output Queue 


“/ 
return Feeder->TaskQ->Gets (Line); 
) 


bool Task: :Puts(const char *Line) 
{ if (TaskQ==NULL) 
{ if (fputs(Line,Fout) !="\n‘) 
/* Send to output file */ 
fputc(‘\n!,Fout) 7 
return TRUE; 
} 
else 
/* Send to this Task’s output Queue */ 
return TaskQ->Puts (Line) ; 


} 


int Task::Getch() const 
{ if (Feeder==NULL) 
/* Get from input file */ 
return fgete (Fin); 
else 
/* Get from Feeder Task’s output Queue */ 
return Feeder->TaskQ->Getch (); 


} 


bool Task: :Putch(char ch 
{ if (TaskQ==NULL) 
{ fpute(ch, Fout) ; 
/* Send to output file */ 
return TRUE; 
) 
else 
/* Send to this Task’s output Queue */ 
return TaskQ->Putch (ch); 


Figure 7 - Interface and Implementation of the Task Class 
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Database reports 
fast and easy! 


“(We) created a report 
in just four clicks of 
the mouse.” 

PC Week, December, 1992 
R&R Report Writer, the 
ultimate data access and 
reporting tool, enables you 
to select, analyse, summarise, 
and present data in any form 
you need — columnar listings, 
form letters, mailing labels, 
business forms, even multi-page 
analytical reports. 


Simply the best for 
all-around report writing! 
R&R has all the features to meet 
your every reporting need. Relate 
and query data, sort and group 
information, use spreadsheet 
calculations and totals. You can 
even format your layout with dif- 
ferent fonts to get polished reports 
that will make you look great! 


Over 150,000 users have 
made R&R Report Writer 
the industry standard... 
R&R consistently wins praise 
from reviewers, developers, and 
end-users alike. And, great 
reports keep coming in: 
“R&R is the best report 
writer for Xbase and may 
very well be among the best 
ever offered for databases.” 
BYTE, July, 1992 


“...the product does exactly 
what it advertises and does it 
well.” DBMS, January, 1992 


(WEEK) 1992. [DAMS 
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may 
J Seas Eee | kod 
Turn your raw data into Le 
useful information. 
R&R’s clean, uncluttered interface 
makes it the most user-friendly 
report writer available today. 
Create any report you need, exact- 
ly the way you need it — without 
having to be an expert in database 
programming. 


QBS Software 


10 Barley Mow Passage, 
Chiswick, London W4 4PH 
Tel: 081 994 4842 
Fax: 081 994 3441 


The professional strength 
report writer. 

R&R is easy-to-use, yet it’s packed 
with features to satisfy even the 
most demanding application dev- 
elopers. Features like an unlimited- 
use, royalty-free runtime version, 
allow you to distribute reports 
freely or weave them into your 
applications—a real time saver! 


FREE demo disk. Call today! 


Concentric Data Systems, Inc. 


410 Turnpike Road, Westborough, MA 015831 - Tel: 508-366-1122 - Fax: 508-366-2954 


In the U.K.: R&R Software Limited - Viking House, Denmark Street, Maidenhead, Berkshire SL6 7XJ - Tel: 44 (0) 628 788181 : Fax: 44 (0) 628 788182 


© 1993 Concentric Data Systems, Inc . All product names are trademarks of their respective owners. 


> CIRCLE NO. 645 


44 


Task object. A fragment of this imple- 
mentation appears in Figure 6. 


I was still unhappy with this solution 
because of all the superfluous copying 
of Task objects. What I needed was a 
way of specifying actual Task objects 
in the pipeline while at the same time 
dealing with just the addresses of these 
Tasks in functions such as operator |. 
Of course C++ has a mechanism for 
doing this - the reference. By using 
Task& in place of Task in parameter 
lists and return expressions, it was 
possible to avoid any copying of 
Tasks. This implementation is shown 
in Figure 7, Because of space restric- 
tions I have omitted the implementa- 
tion of the Queue class, which is just 
a simple ring buffer. 


Groups of Tasks 


The only other class which I want to 
mention here is Grp, which is used to 
simulate bracketing in UNIX shell 
script. This allows a group of Tasks to 
output to the same pipe one after the 
other. For example, the following 
pipeline deletes all files with .TMP and 
-BAK extensions on your C: drive: 


Execute ( Grp(Find 
(Find: :POSTDIR, "C:\\", 
"* TMP"), 
Find (Find: :POSTDIR, 
HOAs BARY) )'OI| 
Rm(Rm::VERBOSE) ); 


As a final example of the versatility of 
this method, here’s a pipeline which 
produces a paginated numbered list- 
ing of a C++ program preceded by a 
function reference: 


Execute( Grp(cFunc() < 
"task.cpp" | SortAlpha() | 
Pr("Functions in task",2), 
LineNum() < "task.cpp" | 
Pr("task.cpp") ) > 
Misting stete jie 


Lest you still think C++ pipelines are 
still of merely academic interest, I see 
no reason why they can’t have em- 
ployed in production code. Where ef- 
ficiency is an issue, the creation of 
special purpose Tasks can replace 
several more general Tasks and re- 
duce the number of steps in the pipe- 
line. This will in turn reduce the 
number of queues through which in- 
formation has to pass. Tasks can be 
used as a convenient way to package 
code from a third party supplier. For 


C++ In Use 
example select () could issue an 
SQL query to select rows from a table. 
An Xmodem Task could be produced 
to allow a pipeline to extend across 
two machines linked by a modem. 
Similarly a DDE Task could be used 
to spread a pipeline across two MS 
Windows programs. Applications are 
limited only by your imagination. 


(exe) 


Declan Brennan’s love affair with com- 
puters dates back to his school days when 
he used to write FORTRAN programs and 
imagine what it would be like to have 
access to a computer on which to execute 
them. After finishing his Electronic Engi- 
neering degree, he has programmed on 
computers both small and large in a 
range of languages. 


Declan has placed the complete Task 
Class Hierarchy in the public domain, 
in the hope that others will use and 
extend it. It is available from .EXE 
magazine on disk. Please follow the 
instructions given in column 1 of the 
Contents Page, and mark your enve- 
lopes ‘TASR’. 


Price: £245.00 


From: Bits Per Second Limited 


14 Regent Hill, Brighton, 


East Sussex BN1 3ED 
Tel. 0273 727119 


Class(y) (c) Anton van Straaten 
dGE, Visual Interface (c) Bits Per Second Ltd. 
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@) 
Visual Interface W' 
CUI bind for ai WS 


Fax 0273 731925 


The VI library contains elements of Class(y) and SuperClass issued under licence. 
You do not need to buy these products to use VI with Clipper 5.01 


SuperClass (c) Chydale Software 


e led the way with dGE. This is the other 


indispensable library for Clipper. For the 
first time your Clipper programs can have 
the look and feel of a Windows application. 


Visual Interface has it all... 


Multiple windows that can be moved, sized, 
maximized and minimized 

A complete range of interactive controls 

An integrated event handler 

Simple to program 

Fully object-orientated 

Runs dGE graphics in it's windows 


Your applications will never be the same.... 


Create graphical dialog boxes, data-entry 


forms and context-sensitive help screens 
Select files from scrolling list boxes 

Import bit-mapped images 

Create queries using icons, radio buttons, and 
check boxes 

Run several windows concurrently and move 
between them with a keystroke or mouse-click 


VI comes with a 250 page manual ihcluding 
over 100 pages of tutorial with examples. 


Requires: 
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Clipper 5.01 

DOS 3.x or higher 
640K RAM 

EGA or VGA 


Hardlock E-Y-E®- tying the hands 
of software pirates 


The effective way to protect your software 
FAST Electronic has made life a lot harder for soft- 
ware pirates. Hardlock E-Y-E was designed using 
cryptographic principles. It took the experience 
and know-how of Germany’s number one in soft- 
ware protection and the leading edge technology 
of a US semiconductor company to create the 
ultimate software protection tool. 


The technology programmers have at their 
fingertips 

Hardlock E-Y-E is based on a custom chip and 
combines all the features that a programmer 
would expect from such a device: secure, algo- 
rithmic query routines and an optional non-vola- 
tile memory for custom configurations. With the 
Crypto-Programmer card from FAST you can pro- 
gram the algorithmic parameters and the memory 
within seconds. This unique card guarantees that 
no one else can burn Hardlock E-Y-Es with your 
codes. Linking Hardlock E-Y-E to your software is 
easy: you can either protect your .COM and .EXE 
files with the automatic encryption software 
HL-Crypt or integrate FAST’s high level language 
routines into your source code. 


Order your demo unit today. Contact Magnifeye, 
235-239 Walmer Road, Walmer Studio # 6, W 11 4 EY, 
Telephone 071 221 8024, Fax 071792 3449. 


Readily acceptable to your customers 

Hardlock E-Y-E allows unlimited backup copies 

of the master floppy. The customer gets the device 
together with the software and plugs it into the 
parallel port between the printer and the PC. Daisy- 
chainability, outstanding reliability and the compact 
high tech design guarantee that your customers 
will accept Hardlock E-Y-E. 


The benefits your management will appreciate 
Hardlock E-Y-E can be programmed by the soft- 
ware house 
with the 
Crypto-Pro- 
grammer card. 
This ensures 
optimum deli- 
very schedules 
and stock flexi- 
bility. Revenues 


will go up as 

software piracy 

and multiple Hardlock E-V-E 

usage are programmable, algorithmic response 
prevented. and memory option - all in one 


MMAGNIF @ 


Magnifeye is a subsiduary of Fast Electronic GmbH. 
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MS-DOS V6.0 


The Ultimate DOS? 


Microsoft is about to release a new version of MS-DOS. 
Cliff Saran has been surveying its new features. 


Despite reports that DOS has been 
more-or-less superseded by Windows as 
the operating system of choice for desk- 
top PCs, Microsoft has written another 
page in the MS-DOS legacy. We look at 
a late beta-release of MS-DOS V6.0. 


Memory Management 


Memory management in MS-DOS V5.0 
was a fair improvement over V4.0, but 
if users needed to squeeze the most 
free memory out of their systems they 
had to purchase third-party utilities 
such as QuarterDeck’s QEMM. With 
V6.0, Microsoft has attacked such 
products head-on. There are new ver- 
sions of EMM386.EXE and 
HIMEM.SYS; an enhanced version of 
DEVICEHIGH and LOADHIGH; and 
MEMMAKER, a tool for optimising sys- 
tem memory automatically. 


The MEM command has been en- 
hanced so that it now provides infor- 
mation on segment addresses/region 
numbers of each block of memory in 
use. 


A new flag, /L, in DEVICE- 
HIGH/LOADHIGH, enables users to 
specify a region number in upper 
memory into which a program or de- 
vice driver should load (again, this is 
a QEMM steal). Fine-tuning system 
memory involves tweaking this pa- 
rameter to extract the most memory 
out of DOS. Obviously this is a time- 
consuming process, so Microsoft has 
provided MEMMAKER for performing 
automatic memory optimisation. This 
takes the QEMM approach of system- 
atically rebooting the machine. Not 
only can MemMaker be configured to 
optimise for Windows, use the mono- 
chrome adapter area at BO00 to B800 
(so long as you’re not using an SVGA 
adapter) or scan upper memory ag- 
gressively, but it also gives users the 
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option of maintaining their existing 
DEVICEHIGH/LOADHIGH settings and 
to choose which device drivers and 
programs to include in the optimisation. 


Networking 


With the launch of Windows for Work- 
groups, Microsoft promised that it 
would provide network client software 
with the next release of DOS. So here 
it is! WorkGroup Connectivity (WGC) 
enables MS-DOS V6.0 workstations to 
connect as a client to Windows for 
Workgroups servers and any LAN 
Manager compatible network. How- 
ever there is no server capability. Mi- 
crosoft has provided an interactive 
network management utility called 
NET which enables users to con- 
nect/disconnect to network drives and 


printers and delete print jobs. WGC 
also includes a copy of MS-Mail, ena- 
bling users to send/receive email, 
save/delete and reply to messages. 


Disk Management 


Following in the footsteps of Digital 
Research’s DR-DOS V6.0, Microsoft 
has added disk compression to MS- 
DOS. The company sees disk com- 
pression as the single most important 
enhancement to MS-DOS. However, 
unlike the disk compression in DR- 
DOS, which was licenced from 
Addstor, Microsoft has gone its own 
way and developed a new disk com- 
pression specification in-house. This, 
despite the existence of well-estab- 
lished disk compression utilities such 
as Stacker and SuperStor. 


Do you find you're being engulfed by trying to manage 
change, but think that using a configuration management tool 
would be an even bigger headache? It doesn’t have to be 
that way. There is a system which can make all of this 
manageable. Configuration management tools from Intasoft 
provide effective, easily implemented solutions across a range 
of platforms which will improve your productivity, reliability and 
quality. 


Available for: MS-DOS, Unix, VMS, OS/2, OS-9 


Tel: 0392 217670 Fax: 0392 437877 
Tresco House 153 Sweetbrier Lane Exeter EX1 3DG 
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Intasoft’s Software Management System (SMS) provides a 
complete, integrated suite of tools that takes the hard work out 
of managing change. The tools included cover version control, 
configuration management and building, and modification 
request management. 


See the light! Call for further details. 
MS-DOS Prices: 1 User £490, 5 Users £980 


Quality tools for 
professional software developers from 


HALO IMAGING LIBRARY 
GIVES PROGRAMMERS THE 


POVVER TO VWRITE 
IMAGING MAGIC. 


A sophisticated toolbox for today's program 
designers who need state-of-the-art imaging 
technology in their soflware programs—read, 
write and convert such popular formats as TIFF, 
PCX, BMP, GIF and more. Enhance and 
Transform your images. ..Pixelize, Posterize, 
Blend and Sharpen...Save time and money with 
this powerful, modular library. Produce 
sophisticated programs using award-winning 
technology from the industry-recognized leader. 
Contact Media Cybernetics to learn more about 
this imaging alchemy... 


CALL 071-833 1022 


"MEDIA “es 
CYBERNETICS” tests, 
The Imaging Experts Motif 


intheux: SYStem Science 


3-5 Cynthia Street, London N1 9JF 
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The specification is called MRCI (Mi- 
crosoft Real Time Compression Inter- 
face).. It ‘defines’ a. set of 
compression/decompression services 
available via INT 1A, enabling soft- 
ware developers to compress and de- 
compress data in their applications. 
Microsoft hopes that hardware manu- 
facturers will developed specialised 
compression hardware which con- 
forms to MRCI. This should remove 
any performance penalties incurred by 
implementing MRCI in software. As an 
added bonus, if hardware manufactur- 
ers start producing MRCI cards, Mi- 
crosoft will have succeeded in 
establishing MRCI as a standard, blight- 
ing any chance that products like Stacker 
and SuperStor will continue in their pre- 
sent, non-MRCI compliant form. 


However before this can happen, Mi- 
crosoft will have to win a lawsuit 
which Stac Inc has recently filed 
against the company for patent in- 
fringement. Stac alleges that MS-DOS 
V6.0 uses technology protected by two 
Stac patents for data compression. 


The first utility to use this technology 
is DBLSPACE, based on the Lempel- 
Ziv algorithms. Microsoft has added a 
new kernel file called DBLSPACE.BIN 
which is loaded immediately after 
IO.SYS at boot-time. Microsoft says 
that an advantage with loading the 
device driver as a kernel file is that it 
eliminates the need to maintain two 
versions of CONFIG.SYS; one contain- 
ing all (uncompressed) files loaded 
before the disk compression driver; 
one containing (compressed) files 
which must be loaded after. As a con- 
sequence of adding a new kernel file, 
FORMAT /S and SYS now copy 
DBLSPACE.BIN in addition to IO.SYS, 
MSDOS.SYS and COMMAND.COM to 
the target disk drive. Microsoft has also 
modified SMARTDRV so that it caches 
compressed data, giving an increase in 
the cache hit-rate (since the cache is 
now storing effectively twice as much 
data), and so improving disk perform- 
ance. 


The installation program DBLSPACE.EXE 
is used to prepare a hard disk for disk 
compression. It creates a new logical 
drive in which it stores uncompressed 
files such as 386SPART.PAR (Windows 
swap file), IO.SYS, MSDOS.SYS and 
DBLSPACE.BIN. It then creates a com- 
pressed volume file (CV) to store com- 
pressed versions of all files on the hard 
disk. As a file is copied into the CV, it 
is removed from the uncompressed 
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drive. The complete process takes 
about 45 minutes on a 40 MHz 386 
(compressing 110 MB drive with 50 MB 
free). A compression ratio of 2:1 can 
be achieved (ie CHKDSK would report 
a 40 MB drive as 80 MB). 


Stac Inc has 
recently filed a 
lawsuit against 

Microsoft for 
patent 
infringement 


Along with DBLSPACE, Microsoft is 
shipping several utilities to help users 
keep their hard disks healthy. MSAV is 
based on Central Point Software’s Cen- 
tral Point Anti-Virus utility. It can detect 
and remove over 1200 known viruses. 
It comes with VSafe, a memory-resi- 
dent program which continually 
watches for viruses. Microsoft includes 
both DOS and Windows versions of 
MSAV. There is a new interactive 
backup utility called MSBACKUP (for 
DOS and Windows) and an enhanced 
version of UNDELETE (again, DOS 
and Windows versions included). Mi- 
crosoft has also licenced DEFRAG 
from Symantec. This is a disk defrag- 
menter based on the one in Norton 
Utilities. 


Miscellaneous 


As well as the major improvements 
outlined above, Microsoft has pro- 
vided a number of useful features to 
MS-DOS. There is now a complete 
online help system based on MS Help, 
which details each MS-DOS command 
and provides example usage. 


At system bootup, <F5> can be pressed 
in order to prevent MS-DOS from proc- 
essing CONFIG.SYS or AUTO- 
EXEC.BAT. This removes the need to 
create a ‘bootable floppy’ in order to 
restart the system (for instance if it hangs 
during bootup). If <F8> is pressed at 
boot-time, the CONFIG.SYS file is proc- 
essed interactively, enabling users to 
choose which commands to execute. 
Microsoft has also added boot menus to 
MS-DOS. New commands in CON- 
FIG.SYS enable users to setup menus 


with default menu items and timeouts. 
Menu blocks in both CONFIG.SYS and 
AUTOEXEC.BAT are invoked when a 
given menu item is selected. 


Along with networking, Microsoft also 
provides INTERLNK, a utility which en- 
ables one PC to access data on another 
using a serial link. While INTERLNK is 
running, the host, server PC cannot be 
used for anything else. Physical disk 
drives on the server can be accessed 
from the client using standard drive 
letters from the MS-DOS prompt. 


Many users will welcome the addition 
of DELTREE and MOVE into MS-DOS, 
providing the ability to delete directory 
trees and move files or directories to 
new locations on disk. 


Hardware Requitements 


A complete installation of MS-DOS 
V6.0 from the four 1.44 MB disks takes 
about 25 minutes and uses a shade 
over 6 MB of disk space. A further 1.3 
MB is required for network services. 
Since DOS system bootable floppies 
must now contain an extra kernel file 
(DBLSPACE.BIN), the amount of disk 
space needed to create a system disk 
has increased from 110 KB to 132 KB. 


Conclusion 


With out-of-the-box networking, ex- 
cellent memory management and the 
disk-doubling capability of 
DBLSPACE, MS-DOS appears to be 
offering extremely good value for 
money. Utilities such as DEFRAG and 
MSAV give users the opportunity to 
maintain optimal performance from 
their hard disks and prevent any nasty 
virus attacks. And the inclusion of 
MSBACKUP and UNDELETE may en- 
courage some users to take greater 
care of their valuable data. In short, 
MS-DOS V6.0 gives users many of the 
tools needed for good ‘housekeeping’ 
- which is exactly what a good operat- 
ing system is supposed to provide. 


In the time-honoured tradition of disk 
compression utilities, DBLSPACE 
scrambled two of the hard disks we 
installed it on. Yes, we know this is a 
beta -" 2 cousider yourselves warned. 
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Microsoft has not announced a price 
for MS-DOS V6.0 yet. We understand it 
will be offered at a similar price to V5.0. 
Microsoft is on 0734 270000. 


ome people say that 
searching for OS/2 software 
is like looking foraneedle in 
a haystack. 


No more. 
The OS/2 Solution Centre has 


changed all that. It is the place to go 
for virtually everything that runs on 
OS/2. With many OS/2 products, a 
library of OS/2 books, support, training 
and technical services, The OS/2 
Solution Centre is the solution to all 
your OS/2 needs 


OS/2 software all sewn up 

Programming tools, utilities, 
applications and every IBM product 
written - and if we haven't got it and 
it exists, we’ Ilshift heaven andearth to 
get it for you. 

Clip the coupon or ring (0285) 
641175 today for our free catalogue. 


Specialist Training for OS/2 

The OS/2 Solution Centre, as OS/2 
specialists, gives you access to some 
of the finest OS/2 training courses 
available - courses that bring 


Sa es ee ee A 


L 


= 


enormous benefits to attendees and 
your company. 
Technical services solving your 
problems 

Although OS/2 virtually eliminates 
the most basic of computing 
problems, it’s nice to know The OS/2 
Solution Centre can provide you with 
access to specialists who can help 
when the more complex situations 
arise. 


A simple way of finding OS/2-based products) 


(Uh TT 


NAME 
POSITION 
COMPANY 


BUSINESS (IY PIs = 
HARDWARE CONFIGURATION 


=== 


Barton House, Barton Lane, Cirencester, Glos. GL72EE. England TEL 
Tel: (0285) 641175. Fax: (0285) 640181. 

Int tel: 44 285 641175. Int. Fax: 44 285 640181 SSS EE OS 
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FAX 
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The support to keep you 
working 


Access to the right level of 


support when youneeditis key 
to the functioning of any 
organisation, The OS/2 Solution 
Centre has the means to help 
you resolve your problems. 

One call and you'll be put 
in contact with a technical 
support specialist who will be 
able to help solve yourproblem 
- or put you in contact with 
someone who can. 

For more information clip 
the coupon or telephone the 
OS/2 Solution Centre Hotline on 
0285 641175. 
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Faith, Hope and Parity 


Jules reviews what is wrong with Artificial Intelligence research, 
and proposes some fixes. What’s more, be does it in two pages. 


By the time they had replaced the 
first blown valve on their first stum- 
bling computers, the engineers and 
mathematicians were thinking seri- 
ously, for the first time in history, 
about machines which could think. 
By the time they had replaced the 
second, they had named this line of 
thought ‘Artificial Intelligence’, and 
by the time they had replaced the 
fifth, they were designing university 
courses in the subject. It’s been forty- 
five years since then, and even 
though wagon-loads of money has 
been spent, vast, dedicated comput- 
ers have been built, and no self-re- 
specting university would be seen 
dead without an AI course, we’re still 
no nearer to making machines that 
think, and no nearer to figuring out 
why it is so difficult. 


Of course, modern researchers are 
not so naive as they were then. Few 
modern researchers would ever ad- 
mit that the goal of AI is to make a 
thinking machine; it is now accept- 
able to set what are apparently more 
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modest goals. Nevertheless, the words 
used to describe the disciplines within 
Al give the lie to this - Expert Systems, 
Machine Cognition, Neural Networks 


Since we can't 
prove that 
machines can’t 
think, we have 
to accept the 
possibility that 
they can 


are all terms which indicate real 
thought. 


Unless one is applying for a grant in 
Al, it is difficult to avoid the conclu- 


sion that AI has manifestly failed to 
fulfil any of its promises. Many, many 
projects have been undertaken, most 
of which have failed to produce any- 
thing really useful, and most of the 
post-mortems of which have claimed 
that the failures were due not to the 
basic ideas, but to the inability to scale 
them up adequately. The response is 
to build yet bigger machines, and to 
develop yet more complex ideas. This 
is in spite of the fact that we can easily 
build and program machines which 
exceed the raw processing power of 
human brains by orders of magnitude. 


Why is AI so hard? Partly because 
nobody has the faintest idea what the 
problem is. It’s hard enough to define 
what a machine is. Trying to explain 
what thought, cognition, and exper- 
tise could be is utterly impossible - 
it’s just something that people seem 
to be able to do better than anything 
else. Even if we could make it, the 
experts are still arguing about how to 
recognise it. This is an important 
issue - if we make a snail-type intel- 


ligence or a cat-type intelligence, we 
probably couldn’t recognise it at all. 
What is being attempted is to make a 
human-typeintelligence, and it would 
appear we have to make it all at once. 


It is this observation which has 
prompted the raging arguments 
among philosophers about whether AI 
is a meaningful term. In return for a 
minimal investment of fact and obser- 
vation, professional thinkers are al- 
most coming to blows over their 
disparate opinions. One of the most 
famous anti-AI protagonists is John 
Searle, whose Chinese Room analogy 
is one of the most famous in the field. 


The Chinese room is, in my opinion, 
a shoddy and pernicious piece of 
work, The logic is trivially flawed, 
and the analogue is far from reliable. 
I can’t help feeling that the reason 
thinkers have lined up to defend 
such tripe is because of vested inter- 
ests. Computers were going to put 
lots of people out of work, but pro- 
fessional thinkers were safe, weren’t 
they? After all, thinking is something 
that people do best, and these people 
think better than most others. What 
use is a skill like that, when engi- 
neers can make machines that think 
just like people do, then scale their 
machines up to make machines that 
are really good thinkers. The irony is 
that professional thinkers, when their 
supremacy is challenged, withdraw 
into emotionally-motivated rubbish 
to defend themselves - at least a 
computer won’t do that. 


And here we approach the next prob- 
lem. Since we can’t prove that ma- 


Artificial Intelligence! 


chines can’t think, we have to accept 
the possibility that they can. Since we 
can't reject the idea that scale matters, 
we have to accept that it might. This 
means we have to accept the possibil- 
ity of really clever machines existing at 
some time. That possibility is seriously 
worrying - if ever there was a Pan- 
dora’s Box, this idea must be it, as 
movies like The Forbin Project 
pointed out. It’s not the engineers’ 
job to worry about the problem, 


If you can get a 
machine to 
understand a 
joke, you can 
certainly get it 
to solve real 
worla problems 


though, and the philosophers are 
avoiding the issue. 


I must say that I’m not against AI 
research - actually, the reverse is true. 
In spite of the fact that we don’t have 
thinking machines yet, the search has 
led to all kinds of other very useful 
techniques, and the collection is in- 
creasing all the time. I even feel that 
the pursuit of a machine that really 
does think is a worthwhile quest, in 
spite of the social problems such a 


for 


machine will bring. I dothink, though, 
that everybody is looking for machine 
intelligence under the wrong stones. 
As I said before, we’re trying to build 
machines that think like people. The 
way to do that is to make a machine 
with a sense of humour. The chimps 
which were taught to sign were pun- 
ning even before they hada fully-func- 
tional language. If you can get a 
machine to understand a joke, you can 
certainly get it to solve real-world 
problems. (Conversely, if it can’t take 
a joke, it probably wouldn’t be able to 
understand any serious problems in 
the first place!) The way to understand 
humour is not to carve it up, but to 
look atthe development of animal and 
infantilejokes. 


I don’t know whether or not ma- 
chines will ever think, though I be- 
lieve they can. I am certain, though, 
that the way to achieve it is not to 
develop ever more complex models, 
nor continually to define and rede- 
fine words like think, understand, 
and argue, words which are simple 
and obvious because every human 
on the planet uses and understands 
them. I have a suspicion that, if and 
when a machine ever is seen to 
think, it will be made not by a 
researcher with a megabuck grant, 
but by an amateur spending his 
pocket-money. 


EXE 


jules.exe has been operating continu- 

ously for three years. He can be con- 
tacted on CIX as jules, or you can 
speak to his voice synthesiser on 0707 
44185. 
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Inheritance 


errs 


Parallel Inheritance, and 
Other Cute Tricks 


Laine presents a method to keep parts of a class hierarchy separated, 
while allowing them to work together at any level necessary. 


Veteran readers of .EXE will know (in 
part, at least) the saga of my Graphical 
Event Based User Interface - GEBUI. In 
the June ’92 issue of .EXE, 1 showed a 


#include <grap! 
#include "tpoint.h" 
#include "trect.h" 
class tGraphics 
{ 
protected: 
static short width, height; 
static short color, style; 
static int xaspect, yaspect; 
static tRect view; 
static tRect clip; 
static tPoint offs; 
public: 
static void SetViewAndClip(const tRect 4v, 
const tRect &c); 
void SetColor (short c) 
} 
void DrawDot (short x, short y); 
oid DrawLine(short x1, short yl, 
x2, short y2); 
tatic void DrawRectangle 
hort top, short right, 
static void DrawCircle(short x, short y, 
short x); 
static void DrawEllipse(short x1, 
short yl, short x2, short 
static void FillRectangle(short left 
short top, short right, short bottom); 
static void FillCircle(short x, short y, 
short x); 
static void FillEllipse(short x1 
short yl 2 
Ve // cla 
class tGraph 
{ 
publi 
tGraphicsInit (); 
static void Terminate (); 
~tGraphicsInit() { Terminate (); 
}; // class tGraphicsInit 
extern tGraphicsInit GrDev; 
// **** end of tGraphics.h 
rcrrrrrrcerttrerrcctetcrecerrcrrccrrs: 


static 


// **** tGraphics.cpp 
finclude "tgraphic.h" 
include <stdio.h> 
#include <stdarg.h> 
#include <stdli 
short tGraphic 

tGraphic 
short tGraphic 

tGraphic: 
int tGraphic 


tGraphicsInit Grbev; // force init 
tGraphicsInit: :tGraphicsInit () 
{ // called only once 
int gdriver = DETECT; 
int gmode = VGAMED; 
initgraph(&gdriver, &gmode 
if (graphresult() != grOk 


oy; 


class I had created to register all point- 
ers to objects of a class called tArea 
(representing any rectangular area on 
the display), automatically assuring that 


{ 
Terminate (); 
puts("\nCan't open graphics device"); 
exit (1); 
) 
// compute the screen dimensions 
struct viewporttype screen; 


width 
height = 


abs (screen, right-screen, left) +1; 


reen,top-screen. bottom) +1; 
getaspectratio(&xaspect, &yaspect); 
view. SizeAbs (width, height) ; 
zeAbs (width, height) ; 
tGraphicsInit ::tGraphics() 
void tGraphicsInit: : Terminate () 

{ 

closegraph(); 

} // tGraphicsInit::Terminate() 
void tGraphics: :SetViewAndClip( 

const tRect &v, const tRect &c) 

{ // set viewport & clip rectangle 

// (clip is given rel. to viewport 

view = vi clip = c; 

offs = lip.TopLeft (); 


// adjust if clip is outside viewport 
if (offs.X() > 0) offs.SetXx(0); 
oO) 
tX (view. Left ()); 
if (view.Top() < offs.¥() 
offs.SetY (view. Top()); 
set viewport (~of fs.X() #view. Left () 
-offs.¥() tview.Top(), 
min(clip.Right ()+view.Left (), 
view.Right ()) 


min (clip.Bottom() #view. Top (), 
view.Bottom()), 
1): 
) // tGraphi 
// ** a few e: 


:SetViewAndClip ( 
mple drawing functions ** 
DrawDot (short x, short y: 
ion of of 
putpixel (xtoffs.X(),ytoffs. 
} // tGraphics::DrawDot () 
void tGraphics: :DrawLine(short x1, 
short yl, short x2, short y2 
{ 
setcolor (color); 
setlinestyle(style, 1, 1); 
line (xl+offs.X(), ylt+offs.¥(), 
x2toffs.X(), y2toffs.¥()); 
cs::DrawLine () 
:iPillEllipse(short x1, 
short yi, short x2, short y2) 
{ 
setcolor (color); 
setlinestyle(SOLID_LINE, 1, 0); 
setfillstyle(SOLID_FILL, color); 
fillellipse ((x1+x2)/2 + offs.X(), 
(yl+y2) /2 + offs.¥0), 
abs ((2-x1) /2), abs (y2-yl) /2); 
) // tGraphics::FillEllipse() 
// ete... 
// **** end of tGraphics.cpp 


Figure 1 - tGraphics and tGraphicsInit class definitions 
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these pointers never pointed to a 
tArea that had been deleted. 


After last month's tour of Multiple In- 
heritance, I thought it high time to 
return to the GEBUI class library and 
discuss some of the methods I used to 
separate the physical aspects of the 
graphics display (how to draw a circle, 
line, etc) from the logical aspects of a 
tArea (deciding which tArea owns 
which part of the display, when to 
repaint, ...), Along the way, there will 
be some helpful hints on using Bor- 
land BGI’s set viewport () function 
to implement useful clipping. 


tGraphics, tGraphicsInit 


Ina GEBUI application, any class whose 
objects will draw on the graphics display 
must be directly or indirectly derived 
from the class tGraphics. This class is 
the interface to the hardware of the 
display device. To save myself pages 
and pages of assembly code, and the 
associated headaches, my implementa- 
tion of tGraphics simply makes calls 
to the Borland Graphics Interface (BGD 
library. The class definition, and a few 
example functions (the others are nearly 
identical) are shown in Figure 1. 


tGraphics has also been tested with 
FlashTek’s Flash Graphics (an updated 
version of the library included with 
Zortech C++ - this version is compat- 
ible with Borland, Microsoft, and Wat- 
com as well). I did this with no change 
to tGraphics, simply linking in the 
BGI2FG module included with FG. 
BGI2FG translates all BGI calls in the 
program to the (very different) equiva- 
lent FG calls. A bit inefficient, but an 
interesting concept. When time per- 
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mits, I will rewrite tGraphics to 
support native FG, as well as Mi- 
crosoft’s graphics library. 


Figure 1 also shows the definition of 
class tGraphicsInit. While any pro- 
gram can have several instances of 
tGraphics (or its descendants), there 
must be only a single object of class 
tGraphicsInit, and its constructor 
should be called before any 
tGraphics member function (and no 
tGraphics function should be called 
after the tGraphicsInit destructor is 
called). This is handled by a) declaring 
a global tGraphicsInit object, and 
b) making sure that all tGraphics 
objects are either local or dynamic. 


Most of you will question why I have 
two separate classes here. The answer is 
a story of evolution. Originally, the two 
classes were one. Each program had 
only a single, global tGraphics object, 
which turned graphics mode on in its 
constructor and off in its destructor, and 
was called by all tArea objects to write 
to the display. For example, to draw a 
filled rectangle, a tArea’s Draw () 
function would have: 


GrDev.FillRectangle(r); 


This was all very pure, and worked 
well enough. However, I hated having 
to type ‘GrDev.’ all the time (surely 
you’ve heard my theory that C pro- 
grammers use C because they’re 
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Clipping rectangle is part which must be redisplayed if Z-order of the 
two tAreas is changed. Of fs is the difference between the two origins. 


Figure 2 - Viewports and clip rectangles can be different 


// tArea.h ~ any rectangular area on the 
4/ screen, 

// Descendants of tArea can use the 
// functions of tGraphics and tRect. 


// waine Stump, 4/23/92 
#include "tgraphic.h" 
finclude "trect.h" 
class tArea : public tRect, 
public virtual tGraphics 
{ 
void ReDrawSub(const tRect &r); 
public: 
tArea *parent; 
tAreaDList children; 
tArea(const tRect &r); 
virtual ~tArea(); 
void ReDraw(const tRect &r); 
void StartDraw(const tRect & 
(Set ViewAndClip (GlobalBounds (),c);) 
void EndDraw () 
{ 
if (parent) 
SetViewPort (parent ->GlobalBounds () ) ; 
} 
protected: 
virtual void Draw(const tRect &r){) 
public: 
// event response functions 
virtual void KeyTyped(short k); 
virtual void MouseMove (const tPoint &p); 
virtual void LeftButtonPressed (const 
tPoint &p); 
VEO ie 
}; // class tArea 
// **** end of tArea.h 
JASE ISIS SUINOISI IEEE ISS II IE 
// tArea.cpp - member functions 
#include "tarea.h" 


// main tArea covering entire display 
tArea *DeskTop = 0; 
tArea::tArea(const tRect &r) 

: tRect (r), children() 


{ parent = focus = 0; } 
void tArea::ReDraw(const tRect ér) 
{ // call to redraw area within r 


if (InDeskTop()) 
( 
tRect tmp = xr; 
tmp *= LocalBounds(); // intersect 
if (!tmp, IsEmpty ()) 
{ 
Mouse->Hide () ; 
ReDrawSub (tmp) ; 
Mouse~->Show () 7 
} 
) 
} // tare 
void tArea:: 
{ 
StartDraw(r); 
Draw(x) + 
children. GotoHead () ; 
while (children.Current ()) 
{ // redraw each child 
tRect tmp 
= x * (*children.Current ()); 
if (!tmp, IsEmpty ()) 
( 
// convert to local coordinates 
tmp .MoveRel ( 
~ (children Current ()->TopLeft ()))+ 
children.Current ()->ReDrawSub (timp) 7 


eDraw () 
DrawSub(const tRect &r) 


// set clip & viewport 
// vedraw ourselves 


children.Next (); 
M 
EndDraw () 7 
) // tArea::ReDrawSub() 
/1 etc... 
//'**** end of tArea.cpp 


Figure 3 - tarea class definition 
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Multiple Inheritance 


lazy...). To get rid of this extra typing, 
I decided to derive tArea from 
tGraphics, thus making all 
tGraphics member functions also 
members of tArea. Now I could filla 
rectangle with just: 


FillRectangle(r); 


However, this change meant that the 
constructor for tGraphics was 
called every time a new tArea was 
constructed. As switching to graphics 
mode (the task then done by the 
tGraphics constructor) not only 
takes time, but also clears the display, 
the result was not acceptable! The 
solution, of course, was to split 
tGraphics into two separate classes, 
one to handle the initialisation/clean- 
up, the other to provide services to 
descendant classes (such as t Area). 


As the data members of tGraphics are 
only used temporarily while a tArea is 
drawing itself, there is no need to have 
a separate copy of them for each tArea. 
Therefore, I declared all tGraphics 
data static (for the uninitiated - static data 
members have only one instance, which 
is shared by all objects of that class and 
its descendants). 


Along with saving space, declaring all 
data as static has the extra advantage 
of allowing me to declare tGraphics 
member functions as static, too. (Any 
member function which uses only 
static data members may itself be de- 
clared as static.) Since static member 
functions don’t need a this pointer, 
the (normally present) push to stack of 
the current object’s address when call- 
ing the function is eliminated, saving 
us time (and stack space). 


Clipping in BGI 


BGI has taken two normally separated 
concepts (viewport and clipping rec- 
tangle) and combined them into one. 
A viewport describes the location of 
the origin (0,0) on the physical display, 
and a window (or ‘Area’) into which 
all drawing should be done; a clipping 
rectangle places boundaries on the 
display - any drawing outside the clip- 
ping rectangle will be ignored. All 
drawing within a tArea assumes that 
the origin is the upper left corner of 
that tArea. However, it is often nec- 
essary to clip to a subregion of the 
tArea’s ‘viewport’ (eg Figure 2). 


Unfortunately, the only clipping that 
BGI will perform is to the boundaries of 
the current BGI viewport, necessitating 
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the Cartesian acrobatics in 
tGraphics: :SetViewAndClip(). 
This function sets BGI’s ‘viewport’ to the 
intersection of the desired viewport and 
clip rectangle, then computes an offset 
from the top left of the clip rectangle to 
the tArea’s upper left corner. This off- 
set (held in the tPoint offs) is used 
during each call to a BGI drawing func- 
tion so that all points are given relative 
to the clip rectangle, rather than the 
viewport. In effect, clipping is done with 
BGI’s ‘viewport’, while the real viewport 
is handled manually by tGraphics 
member functions. 


tArea 


In contrast to tGraphics’ very physi- 
cal view of the display, tArea looks 
at things in a more abstract way. 
tArea is multiply descended from 
tGraphics (tells it how to draw to 
the display) and tRect (tells it where 
on the display it is). Its own data 
members tell it where it is in relation 
to other existing t Areas (on, in, under 
etc). An object of class tArea can’t do 
much by itself - it is merely a base class 
used to derive application classes. A 
tArea derived object will have, at 
least, a Draw () function that contains 
the drawing commands needed to dis- 
play that particular tArea (similar to 
MS-Windows WM_PAINT message). In 
essence, tArea knows what to do, 
while tGraphics knows how to do 
it. Figure 3 shows some important 
parts of tArea’s definition. 


A GEBUI application usually has many 
tArea derived objects on the display 
at any given time. These objects can 
be nested and overlapped in much the 
same way as MS-Windows windows. 
The logic for determining which 
tArea owns a certain part of the 
physical display, and assuring that all 
drawing is performed accordingly, is 
contained within tArea’s member 


Multiple Inheritance 


// tSmiley.cpp - example of 
/ parallel inheritance 
class tGraphicsArc 
: public virtual tGraphics 
{ 
public: 
void DrawArc(int x, int y, 
int stangle, int endangle, 
int radius); 
1; // class tGraphicsArc 
void tGraphicsArc::DrawArc(int x, int y, 
int stangle, int endangle, int radius 
{ 
setcolor (color); 
setlinestyle(SOLID_LINE, 1, 0); 
arc(x + offs.X(), y + offs.Y() 
stangle, endangle, radius); 
) // tGraphicsAre: :DrawAre () 
[ [ek K RR 


class tSmiley 
+ public tArea, 
public virtual tGraphicsArc 


{ 
void Draw(const tRect &r); 


i // class tSmiley 
void tSmiley::Draw(const tRect &r) 
{ 
SetColor (YELLOW) ; 
FillE1lipse (LocalBounds () ) ; 
SetColor (BLACK) 
int rad = LocalBounds() .Right () /2; 
DrawArc(rad, rad, 225, 315, rad*3/2); 


} // tSmiley::Draw() 
// **** end of tSmiley.cpp 


Figure 5 - Class definitions for tGraphicsArc and tSmiley 


functions - in particular, ReDraw () and 
ReDrawSub(). When the application 
wants to update some part of a tArea’s 
display, it simply calls ReDraw () for that 
tArea. ReDraw() hides the mouse 
pointer and calls ReDrawSub () which 
calls Draw () then, in Z-order succession, 
the Draw () foreach child of that tArea. 
The order of drawing controls which 
tArea will be seen ‘on top’ of other 
tAreas. 


Physical Extensions 


Now that we have a basic under- 
standing of how the tGraphics and 
tArea classes work, let’s look at the 
problem of extending the capabilities 
of tGraphics. For example, in a 
tArea derived class called t Smiley, 
we need to draw an arc (for the 
mouth). Unfortunately, there is no 
function in tGraphics which will let 
us easily draw an arc; the best we 
could do is drawing it point by point 
with DrawDot (). How and where do 
we add the function to draw an arc? A 
first look shows us three possibilities: 


1) Modify the original tGraphics, 
adding a DrawArc () function. 

2) Make DrawArc () a member of 
tSmiley, performing the 
operation by repeatedly calling 
tGraphics: :DrawDot (). 


| tRect 


| 
tArea | 
pe 


| tSmiley | 


; 
| tGraphicsArc | 


rie 


tGraphics 


(Note that tGraphics comes to tSmiley indirectly 
via both tArea AND tGraphicsArc) 


Figure 4 - Hierarchy resulting in tSmiley 
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3) Make DrawArc() a member of 
tSmiley, directly calling the 
BGI arc () function. 


None of these alternatives gives me the 
warm fuzzies. 1) is flawed in that it 
requires us to go mucking about with 
debugged code, possibly adding prob- 
lems where they didn’t exist before. It 
also requires the source code to the 
base class, which isn’t always avail- 
able. 2) is not acceptable because not 
only is it inefficient, it also requires us 
to re-implement DrawArc () for any 
other tArea that must draw arcs (or 
alternatively, to derive all such tAreas 
from tSmiley - not exactly an epitome 
of cohesiveness). Finally, 3) is possibly 
the worst of all, as it puts physical 
details and dependencies into a place 
where they don’t belong. Most of the 
reason for separating tGraphics and 
tArea is to make life easier for those 
porting to different hardware/graphics 
libraries. If we mix direct calls to the 
underlying library into tArea deriva- 
tions, the poor sod doing the port must 
search through all such derivations 
looking for our handiwork! 


Finally - PI 


And so we come to my proposed 
solution - yet another use of Multiple 
Inheritance which I call ‘Parallel In- 
heritance’, due to its allowance of two 
or more related class hierarchies to 
develop in parallel with each other, 
coming together to define an ‘applica- 
tion’ class whenever necessary, with- 
out becoming hopelessly snarled. 


According to this scheme, we solve our 
problem by first defining a class 
tGraphicsArc, virtually descended 
from tGraphics, which defines 
DrawArc(), then deriving tSmiley 
from both tArea and tGraphic- 
sArc. See Figure 4 for a hierarchy 
chart of the new classes, and Figure 5 
for the C++ code. 
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The secret to making Parallel Inheri- 
tance work is ‘virtual’. Looking at the 
hierarchy chart, you’ll see that 
tSmiley inherits tGraphics twice. 
Normally that-would cause confusion 
(which instance of tGraphics do I 
use?). But if care is always taken to 
inherit tGraphics and its descen- 
dants as virtual, the compiler will as- 
sure that there is only one tGraphics 
instance in each object of the applica- 
tion class, no matter how many times 
it shows up in the class hierarchy. 


So, in general, to make Parallel Inheri- 
tance work, you should always inherit 
one side of the class hierarchy as vir- 
tual, both within itself, and in its con- 
nections to the other side. 


Advantages 


By using Parallel Inheritance instead of 
one of the three solutions mentioned 
earlier, we dodge several problems: 1) 
we don’t need tGraphics source 
(although we do need to know a bit 
about the implementation of 
tGraphics - eg, how to use offs), 
2) we can easily separate the physical 


and logical side of the hierarchy, mak- 
ing later ports to different hard- 
ware/graphics libraries cleaner and 
easier, 3) because we don’t modify 
existing classes, there is less chance of 
introducing new bugs into working 
code, and 4) the result can be just as 
fast as if DrawArc () had been imple- 
mented in tGraphics originally. 


Although we are using it here to sepa- 
rate the logical and physical concepts 
involved with graphics display man- 
agement, Parallel Inheritance can be 
used in many other places as well. 
And, of course, more than two hierar- 
chies can proceed in parallel with each 
other. In this case, all but one should 
be inherited exclusively as virtual. 


Also, a single hierarchy can split into 
multiple parts somewhere in the tree 
and then safely come back together: 


class tSmiley3D 
: public tArea, 
public virtual tGraphicsArc, 
public virtual tGraphics3D 
Chest De 


tiple Inhe: 


One disclaimer: using Parallel inheri- 
tance to change existing tGraphics 
functions (rather than adding new 
functions) would require those func- 
tions to be defined as virtual in 
tGraphics. As calling a virtual 
function carries a certain amount of 
overhead, I chose to make all 
tGraphics functions non-virtual. 
Gentle readers with an inkling to 
modify existing tGraphics func- 
tions via inheritance are hereby fore- 
warned. 


(EXE) 


A techno-punk who has always wanted 
to coin a phrase, Laine is interested 
whether anyone else bas ever used the 
term Parallel Inheritance’. If not, con- 
sider it copyrighted, trade-marked, 
patented, etc. 


Laine welcomes email at 
laine@trbilun.bitnet. He can 
also be contacted by fax at 010 90 4 
418 5779, or post Bilkent University, 
Lojmanlar 3/9, 06533 Bilkent / 
Ankara, TURKEY. 
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‘The Digital logo, DEC, AXP, the AXP mark and Alpha 
Al 


Here’s how the DEC 3000 
Model 400 AXP workstation 
outstrips other workstations on 
price/performance. 


ai | BM From 
RS6000/Model 350 £13,709 
|] Hewlett-Packard From 
HP 9000/725 Model 50 £13,841 
Digital From 
a DEC 3000 £12,950 
Model 400 AXP 


All machines are 19" monochrome, 32MB memory, 
400 ~ 450 MB disk, operating system licensed. 

But don’t take our word for it: 
UNIX WORLD magazine voted 
the DEC 3000 Model 400 AXP 
‘Product of the Year’ for 1992, 
and even the Guinness Book of 
Records has Alpha AXP as the 
world’s fastest microprocessor. 


This offer ends on March 31st. 
So don’t wait around. Return the 
coupon or call the Alpha AXP 
Trade-in Hotline on 

0256 847848 today. 


Alpha AXP 
This is just 
the beginning... 


AXP are tradomarks of Digital Equipmon|Corporation. UNIX isa registored trademark of UNIX System Laboratories Inc. 


like what I’ve heard so far. Please contact me ASAP to discuss trading in my UNIX Workstation. =o 
Name Position Company 
Address Postcode 
Telephone Current workstation 


Address: Alpha AXP Workstation Offer, FREEPOST, Intec 1, Wade Road, BASINGSTOKE, Hampshire RG24 OBR. 
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™ xBASE 


CA-Ret and R&R 
Head to Head 


Cliff Saran weighs up two new report generators for Windows. 


Last month Computer Associates and 
R&R released new report generators 
for Windows. Both products provide 
xBASE-compatibility; both offer 
‘friendly’ user interfaces. And both are 
able to generate reports of uncanny 
similarity. A confrontation of biblical 
proportions: the mighty CA Goliath 
takes on R&R’s David. 


In the red corner, defending its title as the 
de facto standard xBASE report generator 
is R&R’s latest offering, R&R for Windows 
(RRW). Weighing in at £199, RRW is 
backed by the company’s reputation for 
producing excellent report generators 
and offers backwards compatibility with 
DOS versions of the product. 


The challenger is CA-Ret (pronounced 
‘carrot’), from the company which 
‘writes the software that makes the 
world go round...’ (sung to the melody 
of Michael Jackson’s Heal the World, 
reference: CA technical support). A 
newcomer to the report generator mar- 


ket, CA-Ret is priced at £149 - £50 
cheaper than RRW. Users of R&R can 
upgrade to CA-Ret for &79. 


The Look and Feel 


The CA-Ret and RRW user-interfaces 
are remarkably similar. Both provide 
the same toolbar icons for alignment; 
font selection and point size; and char- 
acter styles (ie Bold/Italics/Underline) 
as Word for Windows, enabling users 
to format and craft the style of a report 
using familiar tools. Each offers a hori- 
zontal ruler calibrated in inches (and 
centimetres too in CA-Ret) and a tool- 
bar for invoking commonly used func- 
tions quickly without the need to 
access pull-down menus. CA-Ret also 
provides a vertical ruler. 


RRW are built from scratch by the user. 
Whether he is producing a tabular 
‘Sales Figures for July’ style report; a 
mail merge for giving standard letters 
a more personal touch; or simply cre- 


~R&R- voucher copies 


rile Edit View Options Insert siEormal) Database ey 


Relations 


Relations: 


ating address labels, the user must 
draw the layout of the report painstak- 
ingly by hand. In particular, creating 
labels involves tweaking the Printer 
setup and running the RRW Default 
Options and Page Layout dialogs in 
order to alter the paper size. 


CA-Ret is stronger in this respect than 
RRW. Although it does provide the 
ability to create reports from scratch, 
CA-Ret additionally offers four built-in 
report styles. The Tabular report style 
is used to display data with a column 
heading and a record in each row - ie 
the format of a sales or inventory report. 
The Form report style displays labelled 
fields on each line of the report as in a 
personnel file. The Form Letter style 
provides the layout for a standard letter 
and the Labels style gives the user a list 
box containing over 70 standard Avery 
labels from which to choose. 


When developing a report it is neces- 
sary to specify which fields it will 
contain. Both products use similar 
mechanisms to achieve this. In RRW 
the user has to double-click on the 
report to bring up a list box containing 
a list of field names in the database. 
With CA-Ret a similar list box appears 
when the user clicks on the Insert Field 
icon in the toolbar. 


Tookup(ORDER-->O_CLIENT. CUSTOMER : CUSTOMER. full, blank)| 
lookup(CUSTOMER—->C_ COUNTRY, COUNTRY : COUNTRY, blank] 
SONG 


No report is complete without a gen- 
erous helping of dividing lines, boxes 
and a company logo on the title page 
to impress the recipients. RRW doesn’t 
provide a way to incorporate bitmaps 
into reports - never mind, have to use 
headed paper instead. It does support 
line and box drawing though. The only 
problem is that box drawing is ex- 
tremely tedious and as user-friendly as 
keying in <ALT> + ASCII code from 
numeric keypad. R&R makes no at- 
tempt to use the mouse to ‘draw’ lines 
and boxes onto a report. Instead it 


[ Relate From 


7 Table: ORDER 
ir] [ Description 

For each ORDER recor 
matching CONTACT tal} 
If no record is found, u 


Field: 


[ Relate To 
Table: CONTACT.DBF 


CONTACT 


Options >>__J 
aes 
Relation Type ——] 
® Exact Lookup 
© Approximate 
© Sean 


Alias: 


[ Relate Through 
CONCLICO.NTX 
b_client+b_init 


Index: 
Key: 


Tags: 


Figure 1 - Linking tables in RGR for Windows 
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FORGET=REST 


GET=BEST 


GRUMPFISH LIBRARY .. . 


Grumpfish Library makes your applications 
more powerful and more appealing, while 
cutting down on your development time. You 
will not have to waste hours learning a new 
language to use Grumpfish Library — even 
new Clipper developers can integrate 
Grumpfish modules into their programs within 
minutes of breaking the shrink-wrap. 


Grumpfish Library is written 99.9% in Clipper, 
and all 5.01 and Summer ‘87 source code is 
included(nearly900K worth). Not onlycan you 
modify the source code to suit your specific 
needs, but it will inspire you to produce more 
efficient and powerful code of your own! 


Grumpfish Library is not merely 5.0 compati- 
ble — it has been completely rewritten from 
the ground up to take advantage of all the 
powerful Clipper 5.01 features. 


Slash your development time with Grumpfish 
Menu! Create working prototypes in minute's 
instead of days Handle change orders in se- 
conds instead of weeks! If you can create a 
text outline file, you can create a gorgeous, 
easy-to-use front end with Grumpfish Menu — 
it's that simple! 

There is no need to learn a template lan- 
guage... juststore yourmenu structure ina text 
outline file, and Grumpfish Menu instantly 
generates optimized, ready-to-compile 
Clipper source code for either Summer'87 or 
5.04! Now you can change your menu struc- 
ture as much as necessary without having to 
worry about screen housekeeping or case 
logic. 

Grumpfish Menu is shipped with two versions 
of the menu generator and linkable libraries 
one for Summer ‘87 and one for Clipper 5.04 

The supporting functions for the menu system 
are written 96% in Clipper. (Assembler is used 
only for transparent shadowing and certain 
string handling/ DOS functions.) 


Grumpfish Menu Features: 


@ Seven menu styles, including pulk down, 
cascading, 1-2-3, and boxed 1-2-3 

@ Hot keys on any menu item (NEW) 

@ Security levels on any menu item (NEW) 
®@ Mobile and resizable menus (NEW) 


London W4 4PH 
Fax: 081 994 3441 


GRUMPFISH, 


a 
PES 


APN! 


Available through 


QBS SOFTWARE 


10 Barley Mow Passage, Chiswick, 


2450 Lancaster Dr, NE, Suite 206, Salem, OR 97305 


Tel (503) 588-1815, Fax (503) 588-1980 


in Clipper? 
productivity 


Grumpfish Library Features: 

@ Pop-up desktop utilities - spreadsheet 
(NEW), calculator, calendar appointment 
tracker, notepad, stopwatch 

@ Numerous extensions to the “ .. GET 
command (CALCULATOR, LIST. PROPER. etc.) 
@ Generic database browser with 
automated record layout add edit view 
QBE routines. Includes a built-in screen 


* painter that lets you design and generate 


Clipper code for your data entry screens in 
seconds! 

@ Nearly 100 functions to make your Clipper 
development life easier 

@ Dynamically overlayable by the current 
crop of dynamic overlay linkers 

@ 30 days free voice support, one year 
unlimited free BBS support 

® Handsome printed documentation, 
Norton Guides reference database 

@ No hassle unlimited royalty-free 
integration license 


@ Built-in tutorial system 

@ Unprecendented aesthetic control — 
change menu attributes from within your 
application without recompiling or relinking!! 
@ User-defined configuration files can be 
loaded at runtime on the command-line — 
each user can have their own interface! 

@ 30. different configuration options 

@ Develop quick prototypes by toggling 
one configuration option. Grumpfish Menu 
will ensure that calls to non-existent functions 
will be handled gracefully, rather than 
crashing your program 

@ Embed source code anywhere within your 
menu structure. 

@ Define your own custom entrance and 
exit routines 

@ Allow users to toggle menu options or tag 
multiple options by adding one line to your 
menu outline file. 

@ Seamless support for Grumpfish Library 
desktop utilities and Dr. Switch-ASE™ 

@ 100% compatible with the current crop of 
dynamic overlay linkers 

@ 30 days free voice support, one year 
unlimited free BBS support 

@ Handsome printed documentation 


081 994 4842 
BBS: 081 747 1979 


INC. 


BBS (503) 588-7572, CompuServe 70673,355 


Grumpfish — Your Guide to Clipper Education and Brose lily, 


relies on Windows’ Character Map pro- 
gram which users must run in order to 
copy box-drawing characters to the 
clipboard. These are then pasted one- 
by-one to form lines and boxes. 


CA-Ret’s approach to line and box 
drawing is: click on toolbar icon; click 
on report and draw box/line by drag- 
ging mouse. Not only is this method 
straightforward, it is a lot faster than 
RRW’s and lines or boxes can be 
stretched or moved by dragging and 
dropping them. CA-Ret reports can 
also contain .BMP Windows bitmaps. 


Connecting Tables 


A report is generated by reading re- 
cords from a database. In a simple 
report these records would originate 
from a single table. A user specifies 
which database fields should appear 
on the report and he may additionally 
wish to sort the records on a given field 
ie to list personnel or products in 
alphabetical order. Finally reports may 
be structured by grouping - eg to list 
the products sold in each retail outlet. 


When a report uses two or more tables 
they must be connected using links in 
order to keep them in synchronisation. 
A link is a field in one table which points 
to an equivalent field in another table. 
This is called a one-to-one relationship. 
Aone-to many relationship occurs when 
one field in the first table points to 
several fields in the second. The termi- 
nology used to describe the relationship 
when several fields from the first table 
point to several fields in the second is 
many-to-many. Both products offer 
these three types of relationship. 


RRW supports the dBASE (DBF) file 
format and all xBASE index file for- 
mats. These include NDX & MDX 
(dBASE), NTX (Clipper), IDX & CDX 
(FoxPro) and WDX (Arago). R&R ex- 
pects to release Paradox, Lotus and 
client-server (eg Oracle and SQL Serv- 
er) versions of RRW by April. 


As well as the ability to use .DBF files, 
CA-Ret can also read text files. These 
may be fixed format, tab or comma 
delimited. It supports dBASE II & III NTX 
indexing, MDX indexing with dBASE IV 
and Clipper NTX indexes. CA has also 
announced that future releases of CA- 
Ret will include ODBC drivers for ac- 
cessing third-party databases. 


RRW and CA-Ret provide interactive 
tool for specifying how tables are 
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linked together. Figure 1 shows the 
‘Edit Relations’ dialog for RRW. Links 
are created by selecting a fieldname 
from the ‘Relate From’ list-box; clicking 
the ‘Related Table...’ button to select a 
table using a File common dialog; 
specify a ‘Relate To’ field for this table; 
and adding an index using the ‘Related 


UDFs enable 
users to 
perform 
complex 

operations not 
supported by 
built-in functions 


Index...’ dialog. RRW protects the user 
by preventing him from selecting links 
between fields of different data types. 
The only area of uncertainty is in 
choosing a correct index file to opti- 
mise the speed of the query. 


Although RRW can’t tell the user 
whether he is about to select the 
wrong index file, it does display infor- 
mation in the index header. So a user 
can see whether he has chosen the 
correct one. The last task is to provide a 
‘Relation Type’. Exact Lookup pro- 
vides one-to-one relationships; Scan 
gives one-to-many and many-to-many 
relationships. With the Approximate 
setting, the link field in the ‘Related 
From’ table is used to find the first record 
in the ‘Related To’ table which has a link 
field that is greater than it. 


CA-Ret uses a tool called the Query 
Builder for creating links between ta- 
bles (see Figure 2). To set up a link, a 
user must first add two or more tables 
to the report. He then fires up the 
‘Query Table Links’ dialog which pro- 
vides two combo list boxes containing 
lists of all the fieldnames in each table. 
A new link is made by selecting a 
fieldname from each list box and click- 
ing on the OK button. Unlike RRW, 
CA-Ret’s Query Builder cannot be used 
to add indexes interactively, although 
if a dBASE IV .MDX index file exists 
with the same name as one of the 
report tables, CA-Ret automatically 


uses it Gincidentally, it is a convention 


Report Generators 


to give the primary index of a table the 
same name as the table). I must em- 
phasise that this facility only works 
with an .MDX index which shares the 
same name as a report table. It won't 
work with Clipper (NTX) or dBASE III 
(CNDX) indexes. 


So to use these types of index files a 
user must modify the query himself. A 
unique feature of CA-Ret is that output 
from Query Builder is a SQL query. A 
programmer can modify this query 
within Query Builder to add such in- 
dexes by hand. However, once a query 
is altered, Query Builder can no longer 
operate interactively and all sub- 
sequent modifications must be per- 
formed by the user himself. Unlike 
RRW, there’s no easy way to determine 
which index file to use ie it doesn’t let 
the user inspect the index file header. 
Another limitation is that the where 
clause in a select statement can only 
use one index file. Add to this, the fact 
that SQL set-oriented database queries 
take significantly longer to compute than 
record-oriented ones, and the result is a 
less than complete attempt by CA to 
emulate the power of relational data- 
bases within the constraints of xBASE. 


Along with links for extracting relevant 
information from the database, both 
products come with expression build- 
ers to reduce even further the subset 
of records returned to the report. Com- 
plex criteria may be built by stringing 
together expressions with logical 
And/Or statements. 


Built-in Functions 


As well as the raw information held in 
the database, the user may wish to 
process the data somehow, and dis- 
play these results in the report. For 
instance a ‘Monthly Sales’ reports would 
normally end with summary information 
containing the number of items sold and 
the amount of money made. Calculated 
fields are used to perform this kind of 
processing using the built-in functions 
provided by the report generator. These 
include functions for summing data and 
calculating an average, minimum or 
maximum value. 


RRW has 87 built-in functions in total, 
based on the xBASE set. Additionally, 
users can create their own user-de- 
fined functions (UDFs) which may be 
used as calculated fields in reports. 
UDFs enable users to perform com- 
plex operations not supported by 
built-in functions. Also, they are not 


System Science 
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UNIX 

SCO Unix Op. Sys SCO Dev elopment Sys. 
SCO Open Desktop (new version 2) 
SCO TCP/IP & NFS FTP PC/TCP 
Interactive Unix Op Sy stem/ Architect Series 
Informix 4GL & SQL RM Cobol-85 
LPI Fortran C Scape Screen Lib 
LPI C++ for 386 Unix & Sun- NEW 

Word Perfect for Unix PC-NFS 
Datesmrerierg & other utilities 

.. many more for 386 Unix and Sun 


Mathematics 
Derive - (with free Intro book) 
Derive also for HP95LX Palmtop 
Mathematica - Sun,HP, DEC and more 
Mathematica Win, 386, Mac, Student Ed 
MathCad for Windows Origin Win Plot 
What's Best! Lindo Linear Prog 
Gauss —_Unistat for Windows - NEW!! 


Windows Development 
(see Microsoft , Borland, Zortech, Watcom) 
ProtoView £325.00 
HALO Image Format File Windows £235.00 
CASE:W 4.0 for MS C/C++, BorAFW £595.00 
Smalltalk/V Windows £310.00 
PCX ProgToolkit Windows £169.00 
Drovers Professional Toolkit £295.00 
INSTALLShield £245.00 
WindowsMaker £call 
Maintainers WB - C Index & Browser £call 
V Basic Windows - addons £call 


CrossDevelopment 
2500AD Cross Assemblers £135.00 
Hitech C Cross Z80, 805, 68HC11.. £345.00 
Introl C or Mod-2 Cross Comp-6809, 68K 
Aztec C68K, Avocet CCross £call 


Pascal (see Borland) 


TopSpeed Pascal SE £115.00 
Object Professional £119.00 
Btree Filer MU £119.00 
Blaise Power Tools £110.00 
Blaise AsynchPlus £135.00 


Fortran Compilers 


RM Fortran £375.00 
Lahey F77L-EM/32 new faster 5.1 £725.00 
Graphoria for F77L-EM/32 £245.00 
Watcom F77 3869 .0-ADS supp £545.00 
Salford FTN 77-386 £745.00 
PC/Interacter (scrns & graphics) £325.00 
Halo Professional for Fortran £245.00 


¢ Prices are exclusive of VAT. 

¢ Prices (except upgrades) include 
delivery to mailand UK. 

* Prices are subject to change. 

¢ VISA, Access and Mastercard 
welcome with telephone orders. 


Microsoft 

Visual C/C++ PE £call 

Visual C/C++ SE NEW Ecall 

Software Version Cohtr £call 
MS Test for Windows £225.00 
MS Windows SDK 3.1 £225.00 
MS Macro Assembler 6.1 £99.00 
isual Basic - Windows 2.0 SE £99.00 
indows Prof Edition £225.00 
6.0 for DOS & OS/2 1.x £245.00 
uick C 2.5 with ASM £95.00 
Basic for MS-DOS £99.00 
Basic for MS-DOS Prof £225.00 

call to upgrade to Visual C/C++ 

Visual Basic Windows - call for upgrades 

Authorised Languages Dealer 


Borland 
Borland C++ & AFW 3.1 
with free Brief Editor - while stocks last 
Turbo C++ Windows 3.1 
Turbo Pascal for Windows 
Turbo C++ with Borland C++ Video 


Turbo Pascal 7 

Borland Pascal with oxgd NE £199.00 

Paradox Engine - ver 3.0 £99.00 
Authorised Languages Dealer 


Nu-Mega Tech. 
Bounds Checker 2.0 ...new £149.00 
Soft-Ice/W ( Windows) £289.00 

with free 'Undocumented Windows' book 


Soft-Ice (for 386 DOS) £289.00 


£295.00 


£85.00 
£89.00 
£65.00 
£75.00 


Intersolv (Authorised) 


PVCS Version Control £345.00 
PVCS Config Build (PolyMake) £175.00 
PVCS Networks, OS/2 & Sun, HP9000£call 
PVCS Reporter for Win - NEW 


MKS 
MKS Toolkit new 4.1 with UUcP & AWKC £195.00 
MKS RCS & Make - Config. Manager £169.00 
MKS Lex & Yacc forC, C++&TP £189.00 


Lifeboat 
Dan Bricklin's Demo II 
PLink 86 + £275.00 
TimeSclicer £215.00 
Tools and Editors, Etc 

CodeWright Editor Windows £175.00 
Borland Brief 3.1 £99.00 
Kedit (Xedit for PC) new ver 5 £110.00 
Select Case - Yourdon or SSADM £495.00 
£345.00 
£149.00 
£60.00 

RM Cobol Developers Pack £call 


£175.00 


3-5 Cynthia St 
London N1-9JF 
Fax: 071 837 6411 


C++ & C Compilers 


also Microsoft & Borland 
Zortech C++ DOS & Win- NEW 3.1 £175.00 
Zortech C++ OS/2 2.0 - NEW 3.1 
JPI TopSpeed C PE 


£295.00 


C++/Views Win,OS/2, Motif 

Zinc Win & Dos - NEW ver £call 
Poet (OOPS Database) £call 
Greenleaf Comm++ (source) preged 
Win++ by Blaise £175.00 


C Datafile 

CodeBase 5.0 for C, C++, Win NEW 

Btrieve - DOS or Windows ver 

Ctree Plus from Faircom £375.00 

Faircom Professional Toolbox £845.00 

Watcom SQL Client/Server Dev Ed. £245.00 

C Communications 

Essential Comms 

Greenleaf CommLib - 4.0 for Dos/Win 

C Asynch Manager (Blaise) 
creens 

CScape with Look & Feel - New 4.1! 

Vermont Views 3 

Panel Plus I! (now withWin support) 

Graphics 

Essential Graphics Kernal 

PCX Programmers Toolkit 

GX Graphics 

HaloProfessional 

Metawindows 4/32 - NEW 

Misc. Libs 

Install& Internat ional Option 

C Tools Plus 

Bar Code Library- source 

... Many more libraries 


£245.00 
£395.00 


£225.00 
£225.00 
£135.00 


£365.00 
£325.00 
£275.00 


£145.00 
£169.00 
£169.00 
£245.00 
£245.00 


£225.00 
£110.00 
£375.00 


Pharlap 386 DOS Ext with ASM386 £335.00 
Pharlap 286 DOS Ext SDK £335.00 
Pharlap 386 ASM/Link/LOC £945.00 


Whats New! 


Microsoft Visual C++/C £call 
Microsoft Software Version Control 
Halolmaging Lib Windows 

image manipulation and transforms 
BorlandParadox for Windows 
special price until 30 April 1993 
Watcom SQL for Windows £call 
true SQL client server for Windows 


£425.00 
£99.00 


071 833 1022 
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attached to the report definition so, 
once it has been created, a UDF can 
be used again and again in different 
reports. UDFs behave in exactly the 
same way as built-in functions: they 
take any number of parameters and 
return a single value. The UDF defini- 
tion is written using xBASE dialect so 
there’s no need to learn a completely 
new language. 


There is no equivalent in CA-Ret. Users 
are stuck with the 41 built-in functions. 


Scan is a powerful function in RRW 
which offers users a (novel) way to 
search for specific records in multiple 
tables. It returns a boolean value of 
TRUE if a given table is being used to 
retrieve the current record. When used 
in conjunction with the IFF function, 
Scan enables users to search multiple 
tables for specific data. A possible in- 
stance where it could be used is in a 
‘New Orders’ report where orders may 
be originate from either a New Cus- 
tomer or Existing Customer table. 


CA-Ret doesn’t support this type of 
database relationship but it can be 
emulated, inelegantly, by nesting CA- 
Ret IF functions together. 


Run-times 


To enable reports to be generated within 
applications, both CA and R&R provide 
cut-down versions of their report gener- 
ators which may be distributed royalty- 
free. These enable users to print and 
preview, but the report design compo- 
nents are absent and cannot be altered. 
The run-time module must be run under 
Windows - there is no mechanism for 
producing reports from within DOS- 
based xBASE products. 


Since a report’s query cannot be 
changed interactively, RRW provides a 
special Control table for specifying 
various parameters which are only 
available at run-time. For instance, it is 
possible to override the default printer 
and provide parameters which may be 
used within report expressions and 
queries. In particular, the RI_QUERY 
and RI_FILTER fields can be set up 
to specify a new query to replace the 
one saved in the report’s definition. A 
programmer may create a front-end for 
his report in C or Visual Basic (VBW) 
which manipulates this table before 
shelling-out to the RRW run-time - thus 
an end-user will be able to specify the 
information returned by the report inter- 
actively. However, there is one draw- 
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|For Help on this clialog, press Ft 


Report Generators 
[= Query QUERY? for YOUCH3.RET ~[~ 
C_ADDRESS1 = ADDRESS2 | C_ADDRESS3 l C_ADDRESS4 | Cc — NAME ia] 
2 uu 8G5.1JQ__ | United Kingd: 
| Pacific House | [3rd Avenue Globe Park | Maitow str 1YL | United Kingd 
fe: WIM 5PE "| United Kingdor|_| 
Tables: t 
COUNTRY & CUSTOMER s | Cancel | 
ts hn, ADDRESS? [a] i 
Californi CT_DIAL CADDRESS3 4 W 
WEST M BT aNaMe C_ADDRESS4 New | sf 
esr er gus a e— 
5 Erognipe C CONTACT [[Deteteitinks 
CT_UPDATE. C_COUNTRY [Ed 


Figure 2 - The o link editor in CA "Rer's rOUay Builder 


back with the RRW run-time system: the 
Control table is a .DBF file, so the C/Visual 
Basic programmer would need a suitable 
DLL in order to access it. 


CA-Ret has a far superior method for 
letting users alter the report’s query at 
run-time. When a report is being cre- 
ated it is possible to set up parameter 
fields which may be used in expres- 
sions and queries. During testing, CA- 
Ret prompts the user to enter values 
for these parameters. At run-time, the 
value of parameters can be specified 
on the command-line. A C/VBW front- 
end is still required, but at least with 
CA’s approach a programmer doesn’t 
have to update any .DBF files. Even if 
the front-end is developed using one 
of the new Windows-hosted database 
managers (such as Paradox for Win- 
dows or Access), at least in CA-Ret the 
user has the choice of which method 
to adopt. 


Documentation 


RRW is supplied with a Using RGR man- 
ual, a Developing Applications guide and 
a Getting Started booklet. The main 
manual covers all features of the product 
and includes a reference of built-in func- 
tions. There is also comprehensive con- 
text-sensitive online help. 


CA-Ret provides a User Guide, a Refer- 
ence Guide a Getting Started booklet 
and a Quick Reference card. In addi- 
tion to describing the main features of 
the product, CA-Ret’s User Guide also 
outlines several sample reports. The 
Reference Guide lists all menus and 
contains a functional reference and an 
appendix on how to use dBASE files 
with CA-Ret. There is online documen- 
tation and help is context-sensitive, 
although I found that the context-sen- 
sitive element was less that complete. 


Conclusion 


Apart from the obvious differences in 
the way they query database tables, 
RRW and CA-Ret expect the user to 
produce reports in a pretty similar way. 
Both report generators give the user a 
distinct set of features - RRW could not 
be used to create reports with embed- 
ded bitmaps; CA-Ret doesn’t offers the 
same level of function support (both 
in-built and user-defined) as RRW. 


Superficially, CA-Ret’s interactive 
Query Builder is as simple to use as 
its RRW equivalent, yet it appears far 
more powerful. Since it is able to 
output raw SQL, developers coming 
from say an Oracle background 
should feel immediately at home. But 
once an experienced user has 
tweaked the SQL it generates, Query 
Builder magically changes its function 
to that of SQL text editor. Although it 
is difficult to document an RRW query 
(since the user cannot ‘see’ what is 
being generated), all queries are built 
in the same way - ie interactively. If CA 
had taken the R&R approach to adding 
indexes, or enabled Query Builder to 
operate interactively once the SQL had 
been changed, my verdict may have 
been different. But since it hasn’t, in 
my opinion R&R for Windows is the 
overall winner. 


CA-Ret costs £149 and was supplied by 
Computer Associates on 0895 272501. 
R&R for Windows is priced at £199 and 
was supplied by RER Software on 0628 
788181. Readers should note that an 
alternative report generator Crystal Re- 
ports has recently entered the market. 
Unfortunately we were unable to fea- 
ture it in this review due to timing 
constraints. 


‘It is practically impossible to teach 
good programming to students who 
have had a prior exposure to BASIC: 
as potential programmers they are 
mentally mutilated beyond all hope of 
regeneration’ 


E. J. Dijkstra, "How Do We Tell Truths That Might Hurt?", 1975 


‘That’s horse.... 
[Expression unclear]’ 


Professor Tom Kurtz, co-inventor of BASIC, Basic Magazine, 1993 


In the current issue of Basic Magazine, we interview the creator of the language about the early days with 
the late, great John Kemeny; about what Microsoft is currently doing to his brain-child; and, of course, 
about all the abuse that the language has taken over the years. And, as you may of guessed, Prof Kurtz 
isn’t taking it lying down. 


Plus: how to write an X-Modem file transfer system, the seven best database libraries for Visual Basic, 
a great competition and loads of tips, hints and tricks. 


For a FREE issue sample issue, please fill in the form below. 


We’re Basic, not sorry. 


Basic 


M-A*G+A+Zel+NeE 


L] Please send me a FREE sample issue of Basic Magazine. 


aiabsdasueiubveseavesee’ JOd Titles .......cocrccossssssssrecsscssrscescecsscenssenssscseesseee COMPANY: ...rovrsvossersrveessecscenesscnssncessnenssecsrsncerenees 


Alternatively, gives us a call on 081 994 6477 to order your issue of Basic Magazine. 
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Pick Lists in Turbo Vision 


The Turbo Vision class libraries in Borland Pascal Version 7 provide a comprehensive 
range of objects to handle data entry. But John Braga has found scope for improvement. 


One test of a good class library is how 
easily you can extend it. Turbo Vision 
provides a wide range of objects to 
help developers design dialog boxes 
for data entry. A pick list, however, is 
not provided. 


It is not difficult to cover this gap by 
using a listbox and an inputline to- 
gether. In fact, the Turbo Vision Pro- 
gramming Guide gives an example of 
this technique on page 225. As the user 
selects an item in the listbox, the in- 
putline reflects the choice. This solu- 
tion has the advantage of using 
standard Turbo Vision objects, but the 
disadvantage of using a lot of screen 


‘real-estate’. Also, the user may not find 
it immediately obvious that the input- 
line and the listbox are linked. 


When I started to consider constructing 
a pick list object which would function 
more like'the combo boxes available to 
Windows developers, taking up virtually 
no space when not in use, I realised that 
the object I had in mind would look very 
like a history window. 


A Snatch of History 


For those unfamiliar with Turbo Vi- 
sion, I should explain that a history 
window appears in a dialog box as a 


down-arrow, normally situated next to 
an inputline. When the user presses 
down-arrow from within the inputline, 
(or clicks on the arrow with the mouse), 
a small listbox-like window appears dis- 
playing previously keyed entries. The 
user can then select any entry by moving 
the arrow keys. Pressing ENTER causes 
the window to close, and the selected 
entry is displayed in the inputline, where 
it can be used as is, or edited. The 
Borland IDE contains several examples 
of this technique. 


Note that users have the choice of 
bypassing the history window by key- 
ing data into the inputline. There is no 


Unit Picklist; 
{$O+,F4+) 
Interface 


8, Views, Dialogs; 


TPICKLIST_REGNO = 3001; 
{used to register the TPickList object} 
{Change it to suit your numbering system) 
type 
= “TPickList; 
= Object ( THistory ) 
: word; (width of picklist 
displayed window} 
word; {help context can be 
used to provide 
statusline hint) 


WHelpctx + 


Constructor Init( var Bounds: TRect 

ALink: PInputLine; 

AHistoryId, AWidth, 

AWHelpCtx: Word ); 
Procedure HandleEvent ( 

vent : TEvent ); 
Virtual; 
TStream ); 
Virtual; 
Constructor Load( Var S : TStream ); 
Function InitHistoryWindow ( 
var Bounds: TRect ) 
PHistoryWindow; Virtual; 


Procedure Store( Var S : 


end; 
Implementation 


Constructor TPickList.Init (var Bounds: 
TRect; 
ALink: PInputLine; 
AHistoryId, AWidth, 
AWHelpCtx: Word ); 
begin {Init} 
{call THistory.Init} 
inherited Init( Bounds, ALink, 
AHistoryID ); 
Width AWidth; 
WHelpCtx := AWHelpCtx; 
end; 


Procedure TPickList .HandleEvent 
( Var Event E 


vent )7 


ryWindow: PHistoryWindow; 


String; 

andleBvent) 

nt ( Event ); 
evMouseDown ) or 

KeyDown ) and 

t.KeyCode ) 

and sfFocused 


( ( Event What 
( CtrlToArrow( E 
and ( Link*.State 
then 
begin 
if not Link*.Focus then begin 
ClearEvent ( Event ); 
Exit; 
end; 
{Get position and size of inputline} 


kbDown ) 
250°) ) 


Link*.GetBounds( R ); 
Dec( R.A.X ) 7 
R.B.X := R.A.X + WWidth + 3; (get width} 


Inc( R.B.Y, 7 )7 
Dec( R.A.Y,1 )3 
Owner*.GetExtent ( P ); 
{Ensure we do not overlap dialog bounds} 
R. Intersect ( P ); 
Dec( R.B.¥,1 )¢ 
HistoryWindow := InitHistoryWindow( R ); 
if HistoryWindow <> nil then begin 

C := Owner*.ExecView( HistoryWindow ); 

if C = cmOk then begin 

{Get user’s selection} 


{get height} 


Rslt := HistoryWindow*.GetSelection; 
if Length( Rslt ) > Link*,MaxLen 
then 


(truncate string to fit inputline} 
Rslt{ 0} := Char( Link*.MaxLen } 
{insert in inputline} 
Link*.Data* := Rslt; 
Link*.SelectAll( True ); 
Link* .DrawView; 
end; 
Dispose ( HistoryWindow 
end; 


Done ); 


ClearEvent ( Event ); 
end; 
end; 


Function TPickList.InitHistoryWindow 
( var Bounds: TRect ) 
PHistoryWindow; 

{the only addition we make to the inherited 
method is the addition of our help context} 
var 

P: PHistoryWindows 
begin (InitHistoryWindow) 

P := inherited InitHistoryWindow( Bounds 
ve 

if P <> Nil then 

P*,HelpCtx := WHelpCtx; 

InitHistoryWindow := P; 

end; 


Procedure TPickList.Store( Var S$ : 
ve 
begin {Store} 
inherited Store( $ ); 
S.Write( Width, sizeof( WWidth ) ) 
S.Write( WHelpCtx, sizeof( WHelpCtx ) ); 
end; 


TStream 


Constructor TPickList .Load( 
de 
begin {Load} 
inherited Load( $ ); 
S.Read( WWidth, sizeof( Width ) ); 
S.Read( WHelpCtx, sizeof( WHelpCtx ) ); 
end; 


Var S$ : TStream 


: TStreamRec = ( 
TPICKLIST_REGNO; 

: Ofs( TypeO£( TPickList )* ); 
Load: @TPickList.Load; 

Store: @TPickList.Store 


begin 

{this automatically registers the TPicklist 
object for storing on streams} 
RegisterType( RPickList ); 

end. 
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Figure 1 - The Picklist Unit 
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obligation to scan the items in the win- 
dow. Users can choose whichever 
method (typing or scanning) they find 
most convenient And the history window 
does not obtrude itself on their notice 
unless asked. The visual resemblance 
between the history window and a pick 
list is clear. The main differences are: 


@ We need to prime the history window 
with the items to be selected, before 
the inputline is used for the first time. 


@ The history window's normal func- 
tion of adding items as the user keys 
them is not required. Our list of 
items will grow only when we ex- 
plicitly add data. 


@ We should provide the facility to 
make the window wider than the 
inputline, since in many cases the 
pick list is used for lists of codes and 
descriptions. Users prefer to scan 
descriptions rather than seeing only 
a list of codes. 


Since Borland kindly provides the 
Turbo Vision Source code with version 
7 of its compiler, it proved quite easy 
to construct the pick list object after 
studying the THistory and THis- 
toryWindow objects (found in DIA- 
LOGS.PAS). HISTLIST.PAS also merits 
a close look, since it contains several 
routines which manipulate the history 
block (the area of memory where his- 
tory strings are stored). 


Take Your Pick 


The new TPickList object is pro- 
vided in a unit called PickList, which 
should be included in any program 
using the facility (see Figure 1). 


Borland’s 
pick-list uses 
standard Turbo 
Vision objects, 
but the 
disadvantage of 
consuming a lot 
of screen 
‘real-estate’ 


To use the pick list: 


® Create an instance of type TPick- 
List and include it in a dialog, 
linking it to an inputline. 


@ Prime it with strings which will 
appear when the dialog is exe- 
cuted, 


Pascal Turbo Vision 


@ (Optional.) Provide a validator 
which will verify that the data en- 
tered by the user in the inputline is 
valid. This will normally mean that 
only data present in the collection 
of strings used in the pick list win- 
dow is allowed. 


Techniques for using the TPickList 
object are shown in TESTPICK.PAS 
(Figure 2). This displays a dialog con- 
taining two inputlines, each with a 
pick list attached. Note that Turbo Vi- 
sion keeps the two lists separate by the 
use of different IDs (see the 
AddPrompts procedure which calls 
HistoryAdd). 


Note also the technique of using a 
validator object to verify one of the 
inputlines. Validators are new to Ver- 
sion 7. In this case we have set the 
ofValidate bit in the inputline’s 
Options field so that validation takes 
place as soon as the user tries to leave 
the field. 


A Few Cautions 


As presented here, the pick list looks 
identical to the History object. This 
will probably not cause confusion unless 
you are using history objects and pick 
lists in the same dialog box, but if you 
prefer, it would be easy to use another 
character instead of down-arrow - per- 
haps an up-arrow. Just override the 
THistory Draw procedure and test for 


Program TestPick; 

{$X+) 

Uses Objects, HistList, Drivers, Views 
Menus, App, Msgbox, Dialogs 
Validate, PickList; 

Const 
omTry 
Helpi = 
Help2 = 


= 100; ID1 = 201; ID2 = 202. 
2101; PickHelp1 = 2102; 
2103; PickHelp2 = 2104; 
type 
TMyApp = object ( TApplication ) 
Constructor Init; 
Procedure HandleEvent 
( var Event: TEvent ); virtual; 
Procedure InitMenuBar; virtual; 
Procedure InitStatushine; virtual; 
Procedure Try; 
end; 
pHintStatusLine = *THintStatusLine; 
THintStatusLine = Object ( TStatusLine ) 
Function Hint( AHelpCtx : word ) : 
string; Virtual; 
end; 
Function THintStatusLine.Hint 
( AHelpctx : word ) 
begin {Hint} 
case AHelpCtx of 


1 string; 


Helpl : Hint :=Enter product, ‘+ 
‘(or press DOWN-ARROW for list)’; 
Help2 : Hint :='Enter industry type, '+ 
‘ (or press DOWN-ARROW for list)’; 
PickHelp1, 
PickHelp2 : Hint := /Use arrows to '+ 
‘select from list, then press EN- 
TER’; 
else Hint := ''; 


end; 

end; 

type 
pPromptCollection = *TPromptCollection; 
TPromptCol lection = 

Object ( TStringCollection ) 
Procedure AddPrompts( AiD : byte ); 

end; 

var 
pTypeColl : pPromptCollection; 
pOutletColl : pPromptCollection; 


type 
pCheckIndustryInput = 
*TCheckIndust ry Input ; 
TCheckIndustryInput = 
Object ( TPxPictureValidator ) 
Constructor Init; 
Function IsValid( const S : string ) 
boolean; Virtual; 
Procedure Error; Virtual; 
end; 


Function trim( const s : 
{removes trailing blanks} 
Var 

i: integer; 
Begin (Trim) 

i r= length( s ); 

while (i > 0) and ( s{i 

dec( i); 

Trim := copy( s, 1, i) 

end; 


string) : string; 


='') do 


Procedure TPromptCollection.AddPrompts 
( AiD : byte ); 

var 
i: integer; 


begin {AddPrompts)} 
for i := Count - 1 downto 0 do 
HistoryAdd( Aid, pstring( At( i ) 
end; 


nat): | 


Constructor TCheckIndustryInput .Init; 
begin {Init} 

inherited Init( ‘*!", FALSE ); 
end; 


Function TCheckIndustryInput. IsValid 


(const $ : string ) : boolean; 
Function Test( ps : pstring ) : 
boolean; Far; 
begin (Test) 
Test := trim( s ) = copy( ps*, 1, 2) 


end; 
var 
ps : pstring; 
begin (IsValid) 
ps := pOutletColl*.FirstThat ( @Test ); 
IsValid := ps <> Nil; 
end; 
Procedure TCheckIndustryInput .Error; 
begin (Erxror} 
MessageBox ( #3/Invalid Industry Type’, 
nil, mfError or mfOKButton ); 
end; 


Procedure SetupTypes; 
begin (SetupTypes) 
New( pTypeColl, Init( 50, 50) ); 
with pTypeColl* do begin 
Insert ( NewStr( ‘Apples’ ) ); 
Insert ( NewStr( ‘Pears’ ) ); 
Insert ( NewStr( ‘Oranges’ ) ); 
end; 
end; 
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Figure 2 - The TestPick Program 
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with on-line man pages 
to supplement the 
complete 2-volume 
Manual. 


The Library is available 
in double precision to 
ensure maximum accu- 
racy of results. 


The functions can be 
called using short six 
character names or 
longer, more descriptive 
names. Names can also 
be re-defined by the 
user. 


The NAG C Library is a professionally developed and supported 
numerical library of functions covering a range of mathematical and 
statistical areas, written in C. 


The Library offers over 200 fully tested and documented functions 
and is available on a range of platforms including Workstations and 
Mainframes. 


The functions covered include: 
* Curve and Surface Fitting * Zeros of polynomials * Sorting 
* Fast Fourier Transforms * Linear Regression * Minimization 


* Linear Regression * Time Series Modelling * Quadrature 
* Ordinary Differential Equations * Sorting * Interpolation 


For further details about the NAG C Library and the other products and 
services available, please contact NAG at one of the addresses below. 


NAG Ltd, Wilkinson House, Jordan Hill Road, OXFORD, OX2 8DR, UK. Tel: +44 865 511245 Fax: +44 865 310139 Telex: 83354 NAG UK G 
NAG Inc, 1400 Opus Place, Suite 200, Downers Grove, IL 60515-5702, USA. Tel: +1 708 971 2337 Fax: +1 708 971 2706 
NAG GmbH, Schleissherimerstra. 5, D-8046 Graching bei Muenchen, Deutschland. Tel: +49 89 3207395 Fax: +49 89 3207396 
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another character in TPick- 
List .HandleEvent. Of course, you 
must choose a character that is not 
handled by TInput Line, which rules 
out normal ASCII characters. 


Turbo Vision saves all strings used by 
THistory objects (and therefore by 
our pick lists) in a single area called 
HistoryBlock, the size of which is 
determined by HistorySize. By de- 
fault, HistorySize is set to 1024, but 
you can set it to another value before 
calling TApplication. Init. (If you 
are short of space and do not use pick 
lists or history objects, there is no reason 
why you should not set it to 0 and save 
1 KB of RAM)). Testpick only uses a few 
hundred bytes, but HistorySize has 
been set to 2048 as an example. 


The variable HistoryUsed shows the 
offset of free space within History- 
Block, so one can determine how 
much space has been used by the 
strings. 


If Turbo Vision does not have enough 
space in the history area, no error is 
shown, but the oldest strings are 
pushed out to make room for the new. 
This makes sense for THistory, but 
is not ideal behaviour for a TPick- 
List! In most applications, it is possi- 
ble to estimate the size of history area 
required fairly accurately, and adjust 
HistorySize accordingly by exam- 


ining HistoryUsed after loading and 
checking that all strings do in fact 
appear in the windows. 


One test of a 
good class 
library is how 
easily you can 
extend it 


Note that the history window works on 
a last-in-first-displayed principle, so 
AddPrompts works from the end of the 
collection to the beginning. 


If your application adds, changes or 
deletes strings which are to be used as 
prompts in TPickList you will want 
to modify the prompts after each 
change. This is best done by a reload. 
A call to the ClearHistory proce- 
dure will clear the area, and 
AddPrompts can be run at any time. 


Further Extensions 


If you are feeling ambitious, there are 
several improvements you could 
make. For example TPickList, as 


Procedure SetupOutlets; 
begin (SetupOut lets} 
New( pOutletColl, Init( 50, 50) ); 
with pOutletColl* do begin 
Insert ( NewStr( ‘Al Agriculture’)); 
Insert ( NewStr( ‘EW Energy’ ))7 
Insert ( NewStr( ‘MM M’‘ facturing’)); 
end; 
end; 


{ TMyApp } 
Constructor TMyApp.Init; 
begin (Init} 
HistorySize := 600; (1024 by default, 
must be set before TApplication.Init) 
if inherited Init then begin 
SetupTypes; 
pTypeColl*.AddPrompts( Id1 ); 
SetupOut lets; 
pOut letColl*.AddPrompts( Id2 ); 
end else Fail; 
end; 


Procedure TMyApp.HandleEvent 
(var Event: TEvent); 
begin 
TApplicat ion.HandleEvent (Event) ; 
if Event.What = evCommand then begin 
case Event .Command of 


emfry : Try; 
else Exit; 
end; 
ClearEvent ( Event ); 
end; 


end; 


Procedure TMyApp.InitMenuBar; 
var R: TRect; 


begin {InitMenuBar) 
GetExtent(R); R.B.Y := R.A.Y + 1; 
MenuBar := New(pMenuBar, Init (R, 
NewSubMenu( '~T~est PickList’, 
heNoContext, NewMenu( 
NewItem( '~T~ry’, ‘F3/, kbF3, 
emTry, hcNoContext, 
NewLine( NewItem( 'E~x~it’, ‘'Alt-x’, 
kbALtX, cmQuit, hcNoContext, 
nil )))), mil) )))7 
end; 


NewMenu ( 


Procedure TMyApp. InitStatusLine; 
var R: TRect; 
begin (InitStatusLine} 


GetExtent (R); R.A.Y := R.B.Y - 1; 


StatusLine := New(pHintStatusLine, 
Init (R, 
NewStatusDef( 0, 0, 
NewStatuskey( ‘’, kbF10, cmMenu, 
NewStatusKey( ‘~Alt-X~ Exit’, 
kbALtX, cmQuit, 
NewStatusKey( '~F3~ Try’, 
kbF3, cmfry, 
nil))), mil) ))7 
end; 


Procedure TMyApp. Try; 
var 
R: TRect; pD : pDialog; 
pI : pInputLine; pV : pView; 
begin {Try} 
R.Assign( 0, 0, 45, 8); 
New( pD, Init( R, ‘Testing PickList’ ) ); 
with pD* do begin 
Options := Options or ofCentered; 
R.Assign( 10, 2, 24, 3); 
New( pI, Init( R, 12) ); Insert (pI); 
pI*.HelpCtx := Helpl; 


mmmmay £77 


implemented here, always selects the 
second item in the list when the win- 
dow appears. It would not be difficult 
to make it focus on the item entered 
in the inputline, or on the first item if 
the item typed in does not appear in 
the list. To do this you would need to 
determine the index of the string in the 
inputline (its position within the his- 
tory block), and override THistory- 
Viewer.GetSelection (which 
controls the list within THistory- 
Window) to focus on the correct 
item. 


Happy picking! 


EXE 


John Braga has worked in IT since 
1967 and the strain shows. After 12 
years in IBM, working with main- 
frames, he left in the early days of the 
microcomputer revolution, to open a 
Byte Shop in Nottingham. He is now 
running a small software house, 
Crown Systems, specialising in PC da- 
tabase applications, many of which are 
written using Borland’s Turbo Vision. 
He can be contacted on CompuServe as 
70134, 201, or at 0480 860349. 


The code in this article is available on 
disk under the usual conditions de- 
scribed on the Contents Page. Please 
mark your envelope ‘PICKLIST’. 


R.Assign( 1, 2, 10, 3); 
Insert ( New( pLabel, 
Init( R, ‘Product:’, pI) ) )7 
R.Assign( 24, 2, 27, 3 )i 
Insert ( New( pPickList, 
Init( R, pI, Idl, 12, 


R.Assign( 18, 3, 24, 4 ); 
New( pI, Init( R, 4) )¢ 


PickHelpl))); 


Insert ( pI )¢ 
with pI* do begin 
Options := Options or ofValidate; 


Set Validator ( 
New( pCheckIndustryInput, Init)); 
HelpCtx := Help2; 
end; 
R.Assign( 1, 3, 16, 4); 
Insert ( New( pLabel, 
Init( R, ‘Industry Type:’, pI) ) )7 
R.Assign( 24, 3, 27, 4); 
Insert ( New( pPickList, 
Init( R, pI, Id2, 30, 


R.Assign( 0, 5, 12, 
PV := New( pButton, 
Init( R, ‘OK’, cmOk, 
pV*.Options := 
pV*.Options or ofCenterx; 
Insert ( pV ); 
SelectNext ( FALSE ); 
end; 
Applicat ion* 
end; 


PickHelp2 ))); 
aa Je 


bfDefault ) ); 


-ExecuteDialog( pD, Nil ); 


var 
MyApp: TMyApp; 

begin (main TestPick} 
MyApp. Init} MyApp.Run; 

end, 


MyApp.Done; 


Figure 2 - The TestPick Program (continued) 
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Zipit UP Software Protection £99.95 
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Support is available beyond 90 days, or on products purchased elsewhere. 


£55 per product or £200 for an unlimited number of products per annum. 


QBS Software Ltd, 10 Barley Mow Passage, Chiswick, London W4 4PH 


UNIX 


PostScript revisited 


Peter Collinson concludes his pragmatic examination into the mysteries of PostScript. 


Last month I described the basics of 
PostScript, the language used to drive 
printers and some visual systems. This 
month I intend to build on that article, 
with an emphasis on what you need 
to know to look at the standard output 
from text processing programs and 
bend them to your needs. 


I have previously covered basic arith- 
metic, positioning and line drawing, 
printing strings and fonts. We saw that 
names or variables and procedures are 
stored in dictionaries along with their 
values. Many settings are effectively 
global and form part of the graphic 
state; for example, the current line 
thickness, the current fill colour and 
the current font. 


Debugging 

I didn’t have space to insert a small 
word about debugging. You can cer- 
tainly waste a lot of trees in trying to 
get one effect correct. These days, I use 
Sun’s OpenWindows on my system 
because it provides me with a cheap 
debugging tool in the guise of the 
pageview command. Some people 
swear by GhostScript as their graphical 
imager for PostScript. The pageview 
command doesn’t get everything right, 
so when in doubt, I fire things at my 
printer. 


My printer is connected to my system 
by a serial line. This means that I can 
see information being returned about 
the state of the PostScript machine and 
whether it has given up because of 
bugs in the PostScript program that I 
have sent it. Sometimes the printer just 
gives up. Microsoft Word (used from 
our DOS machine) has the habit of 
crashing the PostScript machine and 
turning the ‘Reload Paper’ light on. 
Why? I have no idea. I power cycle the 
printer and get on with the job in hand. 


There are some PostScript operators 
that can tell you what is happening 
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inside the system. They will put infor- 
mation into the logging stream and not 
onto the page. The first is pst ack, this 
prints the current contents of the op- 
erand stack in a non-destructive way. 
A program like 


(String) 56 7 mul 5 pstack 
will cause output like: 


--top of stack-- 

5 

392 

String 

--bottom of stack-- 


Microsoft Word 
can crash 
the PostScript 
machine and 
turn the ‘Reload 
Paper’ light on 


Notice how it prints the contents of the 
string correctly. The pst ack operator 
uses the == operator. This intelligently 
prints the topmost value from the 
stack. It is a destructive operation, so 
you should use dup if you want to 
preserve the original stack contents. 
The single equals sign (=) is also a way 
of destructively printing the top of 
stack value. If you want to write text 
up the line to the computer then the 
print operator will send the string 
from the top of the stack up the line: 


random computation 
leaving a result on the 
stack 

(Debug point 1: 
print dup == 


val- ) 


Inserting debugging like this can be a 
great tool. It can tell you that some- 


thing is happening when that piece of 
blank paper appears yet again. Of 
course, if you have written in the space 
that is not displayed it’s not the 
printer’s fault. This can happen all too 
easily, especially when you are trying 
to deal with whole images from other 
places. 


Transformations 


One of the great things about Post- 
Script is the ability to take an existing 
image and shrink or expand it, rotate 
it and place in at a different position 
on the page. Moving the image about 
the page is called ‘translation’, ‘scaling’ 
and ‘rotation’ are self-explanatory. 
When I designed my business card, I 
did it ‘real’ size. I printed cut marks 
around the edges and made sure that 
the printer was printing very black that 
day. I took the artwork to the print- 
shop who really wanted me to print 
two to an A4 page and 2/3rds larger 
than the required size. Back to the 
metaphorical drawing board - but it 
was trivial to add the necessary instruc- 
tions to do this. 


PostScript uses the notion of a trans- 
formation matrix to retain the infor- 
mation about the — current 
transformations. The contents of the 
matrix affect all operations that take 
place subsequently: the values are ap- 
plied to any point that is to be dis- 
played and this evaluates the real 
position on the page. So you can spec- 
ify an image and then change its ori- 
entation and size by preceding the 
original program with some com- 
mands that change the transformation 
matrix. 


There are operators that apply directly 
to the matrix, but this may be beyond 
the wit of many humans whose train- 
ing in matrix arithmetic is often notably 
lacking. This is certainly true for me. 
Luckily, there are simple intuitive op- 
erators that can be used instead. 


VOLUME 15 
MULTIP 


Here is an example program which illustrates the 
power of the Microsoft Foundation Classes (MFC). 
The program is a fully working programmer’s editor 
with multiple windows, Print & Printer Setup dialog 
boxes and a Cut & Paste facility. Other features in- 
clude Search & Replace, Find Next/Previous and 
Tile/Cascade for rearranging windows. With over 55 
KB of source, MULTIP provides a thorough founda- 
tion for building your own MFC applications, 
especially MDI apps. (Public Domain) 


PREVIEW 

It is often necessary to determine which fonts are 
available to the system. PREVIEW is a 500-line 
TPW program which will show you how to do this 
using OWL. The code provides plenty of examples 
on font manipulation, and is an ideal starting point 
for writing applications such as Windows text edi- 
tors. (Public Domain) 


ULTRACLIP 

The problem with the Windows 3.1 clipboard is 
that it only lets the user copy one object at a time. 
ULTRACLIP is a utility which allows you to store 
as many objects on the clipboard as your system 
memory will allow. Each time an object is copied 
to the clipboard, ULTRACLIP creates a new win- 
dow and copies the object into it. Full TPW source 
is included. (Shareware) 

PROFFT 

PROFFT is a Public Domain image processing 
package for Windows which gives remarkable per- 
formance using the Fast Fourier Transform (FFT). 
After a Windows bitmaps (.BMP) has passed 
through the FFT, PROFFT provides the user with 
a total of 7 filters for enhancing the image. Includ- 
ss, Band pass, Butterworth 
s and a freehand filter. Complete 
OWL C++ source included. (Public Domain) 


MASKED EDIT 

Try this. Go into Windows Control Panel and se- 
lect ‘Ports’, then ‘Settings’. Now type in 
your name in the ‘Baud Rate’ edit field. See 
the problem? That's a numeric field, yet Windows 
doesn’t stop Snoopy from keying in ‘Charlie 
Brown s C++ class for OWL enhances the 
standard edit field by allowing the developer to 
specify a Fi lt er containing characters which are 
acceptable as input. MASKED EDIT comes with 
BC++ project and source files and an example im- 
plementation. (Public Domain) 

TXT2RTF 

Before you can start creating your own Windows 
Help files, you’ ve first got to buy a wordprocessor 


Ref: ED153 


EXE Disks 


Volume 15 and 16 of the “EXE Disks’ are now available. 


Packed full of public domain utilities and programs, many with full source code, the new 
-EXE Disks are ideal for any Windows Programmer. Each 3.5" disk contains 700k of compressed files, 
expanding to a stunning 2Mb, the Disks’ contents have been selected by the editorial teams at 
-EXE and Basic Magazine as the best of the thousands of items currently available. £9 per 3.5"' disk. 


like MS Word for Windows which can produce 
Rich Text Format (RTF). Alternatively, you could 
use this DOS-based utility to convert a standard 
ASCII text-file into a RTF file. Special ASCII 
characters are embedded in the text file in order to 
specify Help features such as Titles, Keyword, 
Cross References etc, The text file can also refer- 
ence bitmaps. TXT2RTF comes with an example 
project for BC++. (Public Domain) 


WIZUNZIP V1.1 

WIZUNZIP is a good-looking Windows-based 
clone of the popular PKUNZIP DOS utility for ex- 
panding .ZIP files. It comes with comprehensive 
context-sensitive Windows Help and over 350 KB 
C source, (Public Domain) 


VISUAL LIB 

The Windows 3.1 GDI is rather primitive when 
compa to the graphics API in Windows NT 
(when finally released). Visual Library for BC-++ 
extends the GDI now. It contains powerful curve and 
surface drawing functions including: Bezier, Hermit 
Curves, B-Spline, and NURBS curves and surfaces. 
There are also functions for drawing several types of 
graphics object such as Polygons, Ellipses, Spheres 
and Polyhedra, (Shareware) 


VOLUME 16 Ref: E 


DLLMAKER 

This is a TPW utility for assembling a set of 
units into a DLL. It takes a unit’s interface sec- 
tion(s), and generates two new files: a ‘binderey 
unit’, which repeats all type declarations and im- 
plements all procedures as externals in the DLL, 
and an ‘export library’, which explicitly exports 
public procedures and object methods. (Share- 
ware) 

EDI THREADS 

Threading is the mechanism by which a program can 
be made to perform several actions simultaneously. 
Previously threads were linked with high-powered 
32-bit operating systems such as Windows NT and 
OS/2, but EDI THREADS brings multi-threading 
into the world of Windows 3.x programming. The li- 
brary is distributed as a DLL with BC++ and TPW 
interfaces, (Shareware) 

HEAP AUDITOR 

Failure to free resources is a common headache 
in Windows programming and is extremely diffi- 
cult to track down. HEAP AUDITOR is a utility 
which displays various statistics about the GDI, 
Global and Local Heaps. By checking the report 
before and after the program under examination 
has been run, a developer can determine whether 
memory leaks have occurred. (Public Domain) 


The disks are excellent value for money at only £9.00 incuding VAT. 


To order, complete the form below, or call 081 994 6477 ext 2338 with 


your details. 

| WOULD LIKE: (please tick relevant boxes) 
(quantity) Volume 15 Disk(s) @ £9 
(quantity) Volume 16 Disk(s) @ £9 


Name:..... 


Address:.... 


Please add £1.50 P&P for up to 4 disks - or £2.50 for more than 4 disks 


C lenclose a cheque for £. 


CO Debit my VISA/ACCESS Card by £ 
Card NO? oo. cses ccc cess 
Signed: ........ 


WINDOWS KERMIT 

This is a Windows-hosted terminal emulator 
which enables the user to upload and download 
files to/from remote servers using the widely avail- 
able Kermit file transfer protocol. The package 
includes substantial support for VT100 and VT52 
terminals and comes with over 400 KB of C 
source which can form the basis of a full-blown 
comms package. (Public Domain) 


NNTPW 

The Novell NetWare API can easily be invoked 
from a DOS applications, but it is more difficult to 
access in Windows. NNTPW is an example pro- 
gram written in TPW from the November '92 
issue of .EXE which illustrates how it’s done. 
(Public Domain) 


OWLBWCC 
OWLBWCC is a group of 18 example programs 
(with full source code) for using Borland custom 
controls (BWCC) with OWL, The examples in- 
clude: how to create a basic BWCC dialog box 
with metal background, group boxes, bumps and 
dips; how to use a large custom button as ¢ 


screen and how to perform delayed processing. 
(Public Domain) 

IDLE 

In the December 1992 issue of .EXE Laine 


Stump described an extremely elegant way to 
perform background multi-tasking in Windows 
using a generic class derived from Microsoft 
Foundation Cl. IDLE contains the code 
from the article, There’s over 200 KB of source, 
including Laine’s MFC code for a thermometer 
custom control. IDLE is bound to teach you 
many new tricks. (Public Domain) 

XLMATH 

This is a DLL which extends Microsoft Excel by 
providing custom functions including diagonal 
a real symmetric matrix, creating a frequency dis- 
tribution and curve fitting functions. C source code 
is included for extending the DLL and the documen- 
tation looks into the difficulties with writing DLLs 
for Excel such as memory issues, Excel’s instance 
handle and Excel data types. (Public Domain) 
UNDOCFCT 

How can you be sure that the software you're run- 
ning will be compatible with future releases of 
Windows? Many commercial Windows applica- 
tions rely on undocumented Windows API calls. If 
Microsoft alters these undocumented functions at a 
later date, such software may not function correct- 
ly. UNDOCFCT is a utility which provides an 
early warning of potential incompatibility by print- 
ing all undocumented entry points and external 
references in a Windows executable. (Shareware) 


Please return this form to: 


.EXE Magazine, FREEPOST, 10 Barley Mow Passage, 
Chiswick, London W4 4BR 


If you want to move the origin of the 
drawing operations, then the trans- 
Late operator is used. If you have just 
been sent a PostScript document in- 
tended-for US paper, then you might 
like to move each page up by half an 
inch when printing it onto A4. Remem- 
ber that an inch is 72 points in the 
standard coérdinate system and we 
can insert: 


0 36 translate 


at the start of each page. Generally we 
cannot do this once at the top of the 
program when the program consists of 
several pages, because the first show- 
page operator will reset things back 
to the way they were at the start of the 
document. You will often find that the 
simplest way to make a change is to 
add something at the start of each 
page. So we have to find the start of 
each page and insert our command 
there. Most PostScript documents will 
follow the standard ‘document struc- 
turing’ conventions which says that 
each page should be preceded by a 
comment: 


S%Page: 14 14 


This is the tag for page 14. The first ‘14’ 
is a label and is intended to be the 
same page number form that is used 
in the text, so if the text was numbered 
in roman numerals this would contain 
‘xiv’. The second ‘14’ is a number, it’s 
the decimal value of the page number. 
If we look for this comment we can 
find the start of the page. It’s easy to 
write a script to append the translation 
that we need after the comment: 


#!/bin/sh 

# file on stdin 

# output on stdout 
sed -e '/*%%Page/a\ 
0 36 translate 


, 


Actually, it’s possible to code the origi- 
nal document to make this approach 
very difficult. There are cases where 
this will not work and you will need 
to expend some brain cells in decod- 
ing what is happening elsewhere in 
the PostScript program. Perhaps the 
page settings are changed before your 
code can be actioned. When writing 
this article, I played with a document 
whose prologue had moved the page 
origin from its normal position in the 
bottom left-hand corner to the top left- 
hand corner. So I had to use 


0 -36 translate 


to move the page image up the page. 
Another favourite trick of PostScript 
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prologue designers is to scale the page, 
perhaps by 10, so 72 points are no 
longer an inch - 720 is the magic 
number. You can check up on these 
things by drawing a supposedly one- 
inch box somewhere on the page and 
measuring. If your changes are having 
no apparent effect, try translating the 
page by a 1000 or so in one direction 
or another. If things are still not work- 
ing, you need to start searching for 
hidden save/restore pairs that may 
be resetting things after you have in- 
serted your commands. 


If you are 
writing 
PostScript, you 
should assume 
that the code 
will find its way 
into another 
document 


In my demo case, the prologue has 
taken it into its head to scale the page 
as well as move the origin. My one inch 
sample box is actually a quarter of an 
inch too big. This is the result of some 
code in the prologue that ‘knows’ 
about the resolution of the final output 
device. Ho ho, my device has a differ- 
ent resolution from the one that the 
document was originally prepared for. 


Scaling is as easy as translation: 
2 1 scale 


doubles the size of any object in the 
x-direction and leaves the y-direction 
alone. You can use fractional values to 
make things smaller: 


0.5 1 scale 


will put the previous scaling factor 
back into force. The ability to shrink 
and expand things is a great boon. One 
reasonably safe way of mapping the 
US page onto the A4 is to use scaling. 
Take my sed script above and change 
the translate line to read: 


0.9705 1.06818 scale 


This scaling factor will be applied after 
each %%Page directive. Scaling the 
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page like this does look OK but 
stretches the characters somewhat. It 
will stretch graphics too: circles will 
become ellipses. In some circumstances, 
the final effect might not be satisfactory. 


The third transformation is rotation. 
The command has a single parameter, 
the number of degrees to spin. 


90 rotate 


This is measured anti-clockwise. A 
negative parameter gives clockwise 
movement. Rotation is useful at the 
page level when you want to change 
the orientation of the page from por- 
trait to landscape. I recently needed to 
produce an A5 booklet, printing the 
pages in pairs side-by-side on an A4 
sheet. I wanted to produce the output 
in numeric page order for proofing and 
then in the peculiar ordering that is 
needed to create a booklet. If this 
confuses you, get two ‘Post-its’ and 
fold them in half to make a little book. 
Now, number the pages. See how page 
1 is on the same sheet as page 8, page 
2 with page 7 etc? 


It’s much easier to do this automat- 
ically by dealing with the PostScript 
than fighting the documentation sys- 
tem. I have used a so-called ‘publish- 
ing’ system where I had to arrange 
the pages entirely by hand. Once was 
enough. I wrote a C program that 
scans the PostScript for the pages and 
‘edits’ them into the correct order. It 
also inserts the PostScript to move 
the pages into the correct place on 
the final sheet. Before I get requests 
for this program, it is highly tuned 
towards the particular text process- 
ing system I use and I don’t expect it 
to port outside my immediate envi- 
ronment. These things are not hard, 
once the idea is suggested to you. 


Interfering with the code 


What happens if we want to add a 
huge chunk of code into a PostScript 
program so that it produces some 
effect without ruining the remainder 
of the document? We need to save 
the state of the PostScript machine, 
do our stuff and then put everything 
back as if nothing had happened. 
There are several operators designed 
to save the state of the PostScript 
machine. 


If you look in the books, you might 
imagine that the pair to use are save 
and restore. It depends, but I tend 
to steer clear of these. They save the 
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whole PostScriptmachine, notonly the 
graphics state but the values of vari- 
ables in dictionaries, the presence of 
variables and procedures in dictionar- 
ies etc etc. They can be sledge-ham- 
mers in our context. We need 
something a little less drastic. 


The’ basic pair are gsave and 
grestore, The gsave command 
saves the current graphics state on a 
special stack. You can now change 
anything in the graphics state in the 
secure knowledge that you can re- 
cover the previous state using the 
grestore command. 


The stack is limited in depth, so you 
cannot be too profligate with stacking 
the old environment. If you need to 
reset things more than once, then you 
should do something like: 


gsave 


grestore % reset once 


gsave % save again 
grestore % reset twice 


If you are constructing any piece of 
PostScript, then you should assume 
that eventually the code will find its 
way into some other document. The 
code should have zero impact on the 
PostScript machine: it should leave 
things as it found them. If the Post- 
Script is an image like a logo, you 
should control the position by an 
external move to a starting position. 
Within the PostScript fragment, all 
positioning commands should be 
relative to that starting position. 


The PostScript should use the current 
transformations, so the image will 
work if the external page is rotated. 
You should ensure that you use 
gsave/grestore pairs to save 
graphics. state rather than any of the 
several operators that are designed to 
reset initial state. You will find that 
most standard prologues do follow 
these rules. 


Dictionaries 

We can deal happily with any effect 
we might have on the graphics state. 
What about any name that we might 
use? Can we have local names for 
routines and variables? The answer to 
that is ‘yes’, it’s trivial to do so. 


The default PostScript engine has two 


dictionaries, the system dictionary and 
the user dictionary. These dictionaries 
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live ona stack, with the system diction- 
ary pre-loaded on the bottom and the 
user dictionary above that. When the 
system needs a name, it searches from 
the top of the dictionary stack down- 
wards for the name before giving up 
and complaining bitterly. Notice that 
this means it is perfectly possible to 
redefine the action of operators like 
showpage by simply providing a new 
definition. This will insert a new rou- 
tine in the user dictionary that will 
override the default definition in the 
system dictionary. 


For small systems, the user dictionary 
is fine. It provides us with a flat name 
space that we can see and easily con- 
trol. When things get bigger, we may 
want to define our own dictionaries 
and push them onto the stack. To 
make a dictionary we say: 


/Local 25 dict def 


This defines the name Local to be a 
dictionary capable of holding 25 ob- 
jects. To start using the dictionary, we 
must push it onto the dictionary stack 
using the begin operator: 


Local begin 


% define names 
end 


The end operator removes the diction- 
ary from the dictionary stack. This 
takes the names that the dictionary 
contains out of scope, although they 
can be directly addressed by get and 
put operators. I intend to skip over 
that here. To access the names, we 
need to bring the dictionary back into 
scope. This is easy, simply re-issue the 
begin statement for the dictionary. 


If I want to have variables that are local 
to,a procedure, I can create a local 
dictionary for them. In last month’s 
article, we had a routine to generate a 
box and we needed to have a variable 
to store the length of the side. We can 
now write the routine so that the vari- 
able is local to the procedure: 


/square { % side -> 
1 dict begin 
/side exch def 
0 side rlineto 
side 0 rlineto 
0 side neg rlineto 
closepath 
end 

} def 


Now the side variable is local to the 
procedure, the local dictionary is 
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createe whenever the routine is called. 
The routine simply adds the name 
square to the global name space and 
keeps its own names to itself - all in 
the best traditions of structured pro- 
gramming and name space hiding. 


In fact, none of the word processing 
prologues that I have seen make ex- 
tensive use of local dictionaries. How- 
ever, programs that are intended to 
create embedded PostScript fragments 
do try hard to use these features of the 
language so that their output is as 
portable as possible between different 
environments. 


More reading 


The use of a transformation matrix is 
explained in any reasonable book on 
computer graphics; for example: Fun- 
damentals of Computer Graphics by 
Foley and van Dam, Addison Wesley 
1982 or perhaps Principles of Interac- 
tive Computer Graphics by Newmann 
and Sproull, published by McGraw- 
Hill, 1981. 


A book that I like is Real World Post- 
Script edited by Stephen F Roth pub- 
lished by Addison-Wesley, ISBN 
0-201-06663-7. This is a book by 
graphic designers rather than com- 
puter freaks and includes a lot of ‘real 
good stuff on how to deal with Post- 
Script. 


The PostScript Language Tutorial and 
Cookbook by Adobe (ISBN 0-201- 
10179-3) has a blue cover. The Post- 
Script Language reference manualalso 
by Adobe (ISBN 0-201-10174-2) has a 
red cover. The PostScript Language 
reference manual, Second Edition is an 
immense book that describes the re- 
cent extensions to the language such 
as colour and display PostScript, its 
ISBN is 0-201-18127-4. I am not sure 
that I would point a learner at this 
book. You’d do better to try and find 
the original release of the book and 
graduate onto the Second Edition at a 
later date. All these books are publish- 
ed by Addison-Wesley. 


Peter Collinson is a freelance consult- 
ant specialising in UNIX. He can be 
reached electronically as pc@hill- 
side.co.uk (although your mailer 
might be happier to put the address the 
other way round) or by phone on 0227 
761824, 
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Books Received This Month 


No Bugs - 

Delivering Error-Free code in C and C++ David Thielen Addison Wesley $24.95 0-201-60890-1 pp206 
Writing Device Drivers for SCO UNIX Peter Kettle and Steve Statler Addison Wesley £22.95 0-201-55425-3, pp353 
X.25 Made Easy Nicholas M Thorpe and Derek Ross Prentice Hall £17.95 0-13-972183-5 pp191 
The Steve Straley Seminar: Clipper 5.0 Stephen J Straley Bantam £31.99 0-553-37059-6 pp491 
Inside Windows NT Helen Custer Microsoft Press £22.95 1-55615-481-x pp385 
C and the 8051 - Programming and Multitasking Thomas W Schultz Prentice Hall £42.80 0-13-753815-4 pp366 
The Advanced C++ Book MT Skinner Prentice Hall 422.95 0-13-088493-6 pp209 
Data Analysis - an introduction Jeffrey A Witmer Prentice Hall £16.50 0-13-205238-5 pp122 
Developing C++ Software Russel Winder John Wiley $19.95 0-47192110-3 pp494 
Borland C++ 3.1 Object-Oriented Programming Marco Cantt and Steve Tendon Bantam £27.99 0-55337086-3 pp626 
X.desktop Code Book Michael Bagard and Mike Moore Prentice Hall £24.95 0-13-978537-X pp327 
BiNet for VMS Users Michael A More and Ronald A More _ Digital Press 837.45 0-13-928797-3, pp161 
Principles of Object-Oriented Analysis and Design James Martin Prentice Hall £43.85 0-13-720871-5 pp412 
The C++ Primer - a gentle introduction M T Skinner Prentice Hall 419.95 0-13-088501-0 pp295 
Computer System Architecture Scott Robert Ladd Prentice Halll £19.95 0-13-117037-6  pp460 
Object-Oriented Software Development - 

a practical approach Mark Lorenz Prentice Hall 433.30 0-13-726928-5 pp227 
Program Design Peter Juliff Prentice Hall £20.95 7248-0916-3 pp340 
Understanding OSI Applications Colin L’Anson and Adrian Pell Prentice Hall 851.35 0-13-639444-2 pp370 


Our favourite of this month’s batch is No Bugs/, by Microsoft Ace programmer David Thielen. Thielen’s style will be familiar to 
.EXE readers from his ground-breaking Windows VxD article last year; he certainly doesn’t tone it down for the new format. The 
use of the word ‘bugs’, says Thielen, allows us to believe that our programs are corrupted by some outside agency; we should 
be calling them Massive Fuck-Ups (MFUs), which leaves no doubt as to where the blame lies. (If this is too strong meat for you, 
the book contains more of the same, eg ‘Oh shit!’ MFUs, so perhaps best to leave it alone.) 


Aimed squarely at C/C++ programmers/testers working in the PC/DOS/Windows environment, the book catalogues all the 
standard techniques - #IFDEF DEBUG, assertions, stack and heap watching and so on - but enriches them with personal 
experience and anecdote. It does not resemble the standard po-faced effort put out by an academic who thinks that QA is a 
good idea - this guy has been there. A good chapter on modern debugging tools at the back (no it doesn’t eulogise CodeView), 
and two appendices with useful routines for driving MDA monitors and debug message boxes. Recommended. 


And if you are wondering where Dan O’Brien is then: so are we, but more so. 
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Half the cost 
NOT 
half the dongle 


Softlok II Keys, developed by Softlok International, 
have been designed to be an effective yet low cost 
solution to software piracy. Designed and 
manufactured in the UK for software developers 
worldwide, Softlok II contains all the flexibility you 
will need to protect your software. 


Softlok II units are sophisticated keys containing 
240 bytes of secure non volatile memory. An 8 
byte password provides read/write protection. Both 
the memory area and password can be changed 
using the supplied routines from your application. 
As aprogramming adaptor is not required, they 
can also be altered in the field. 


Our low cost starter pack contains everything you 
need to get you quickly up and running with 
routines provided on the disk for most DOS and 
Windows compilers. We can usually ship Softlokll 
Keys for next day delivery so that you can get your 
software on the market just as quick. 


Alliprices exclude VAT and delivery 
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Proving the Rule 


Mike Banahan explains the need for C++’s exception-handling mechanism. 


We open this month with the kind of 
commercial that is hard to ignore: come 
to the European C++ User Group con- 
ference in Munich next July (7th-9th), 
or we'll send round the boys and the 
safety of your kneecaps will become a 
matter of no little concern. ’Nuff said, 
probably, except that there are already 
a number of interesting papers on the 
programme, including one from Bjarne 
Stroustrup himself. Be there or be con- 
demned to staying sober... 


I was there last week (now you can work 
out what the production deadlines for 
.EXE are), checking out the facilities: the 
Paulaner brewery, various kinds of seri- 
ous sausages and an unpronounceable 
Bavarian delicacy called obat’zda (or 
something like it) which is not only deli- 
cious but apparently equally at home as 


void do_good_stuff (void), 
f£1(void), £2(void), 
fn(void); 
jmp_buf ejmp; 
main() { 
if (set jmp (ejmp) ) ( 
fprint£ (stderr, 
"An error occurred..."); 
exit (EXIT_FAILURE) ; 
) 
do_good_stuff(); 
) 
void do_good_stuff(){ £1();) 
void £1()( £2(); ) 
void £2(){ £n(Q);) 
void fn() ( 
/* various things - 
then we find an error */ 
longjmp(ejmp, 1); 


Figure 1 - 
The setimpO/longjmpO approach 


class myerror(}; 
void £1(), £2(); 
main () ( 
try{ 
£107 
) 
catch (myerror) { 
// Handle the error 
) 
return 0; 
) 
void £1(){ 
£2007 
} 
£2.() { 
// do things, 
// then create an exception 
throw myerror(); 


} 


Figure 2 - C++ Exceptions 
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a remarkable cheese’n’onion dish or a 
repair for the worst ravages of time and 
rock-salt on the bodywork of antique 
Ford Capris. The ostensible reason for 
attending was the OO/C++ World con- 
ference being held there, and I’d 
threatened Will Watts that I’d write up 
the proceedings. The results of the 
extracurricular activities being what 
they were, I fear that recollection is 
hazy, so here’s something different 
instead, 


Before the fuddling vapours rose too 
high, a small group of us was discussing 
one of the more rarefied additions to C++: 
exception handling. It’s fairly clear that 
this is a subject area which isn’t under- 
stood all that clearly by the majority of 
C++ users and one which could do with 
a bit of illumination. Let me set myself the 
task of doing what I can about it. We'll 
start by asking why it’s there and with a 
warning: just because a language hap- 
pens to have a feature, you don’t have to 
use it. I suppose it’s a forlorn quest to try 
to persuade folk not to play with new 
toys, but I’m already dreading the kind of 
half-baked things that this little goody will 
be used for. 


Here goes with the why - next month 
the how. 


Although it’s a general problem, library 
designers in particular have a nasty diffi- 
culty to get around. They are trying to 
design reusable software components 
which don’t have to be changed (that’s 
‘changed’ spelled H-A-C-K-E-D) by users 
when they don’t quite fit the problem at 
hand. If the library class doesn’t do exactly 
what you need, at least a C++ program- 
mer has the possibility of using language 
features like inheritance to modify the 
interface as needed. Interfaces are one 
thing - but error handling policy is some- 
thing else again. 


The root of the problem is that when 
errors are detected, they are found deep 
in the library modules, but that isn’t the 


point where you know what to do 
about the problem. Almost any choice 
of action is going to be wrong. Only 
the caller of the library knows what 
would be right, yet only the library 
code knows about the error. We've got 
a serious problem on our hands; we 
need long-range communication be- 
tween two independently imple- 
mented parts of a system. It’s a problem 
with a number of solutions, but there’s 
no one which is always correct and 
some solutions are good but very hard 
to implement. We ought to review the 
more popular ones. 


The first solution is to consider any 
error to be fatal. The usual thing is to 
print some kind of error message 
(easy enough on DOS/UNIX when 
there is a standard error channel to 
write to, but harder on Windows and 
often impossible in embedded sys- 
tems), then to halt the program. This is 
an imperfect solution for software sys- 
tems such as automatic pilots and nu- 
clear controllers, but it’s popular and 
easy to implement where it’s ‘adequate’. 
Lots of C programs take this approach. 


The second solution is to try to let 
the user of the library know that an 
error occurred and to give them some 
chance to correct the problem. The 
most common way of doing this is to 
set either a global error flag, as with 
the errno technique in C, and/or to 
have error return statuses from li- 
brary functions. This is fine, but it 
suffers from two unpleasant weak- 
nesses. One is that lots of programs 
don’t test for the error; the other is 
that so much code is used to check 
the error condition that you can’t 
work out what should happen when 
there isn’t an error! We can’t do much 
about programs that fail to check, but 
we may be able to reduce the clutter. 


It’s no joke when some 50% or more 
of the code is taken up with error 
handling. It really is hard to work out 
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of the time that the error doesn’t hap- 
pen: 


while(( c = getc(fp) != EOF) 
&& !ferror(fp)) 
if (!ferror (fp2) ) 
putc(c, fp2); 
else 
// error-handling stuff 


For heaven’s sake, we're only copying 
one file to another. It’s even worse when 
you then have to return an error status 
which ripples up 15 levels of function 
calls (each checking the status) until the 
caller can do something about it. 


Advanced users may use 
set jmp ()/long jmp () to get around 
it, as shown in Figure 1. This works well 
for those who can understand it. The first 
call of set jmp () returns 0, so the call 
of do_good_stuff() is executed. 
The call of long3jmp() has a bizarre 
effect - it doesn’t return in fn(), but 
instead it returns a second time from the 
call to set jmp () in main! It’s really an 
inter-function goto. 


This would be nice but for one tiny fault 
- imagine that £1() opened a file, or 
allocated some memory, then called 


£2(), and then closed the file or re- 
leased the memory. It would work per- 
fectly until the long jmp () happened, 
but then the file would be left open or 
the memory lost. If all the program did 


We all 
know that 
global variables 
are generally 
bad news 


was exit (like the one above) that 
might not be too bad, but if it had to 
continue it could easily be in trouble. 


Programs which make use of 
set jmp ()/longjmp() for routine 
error or event handling are not easy to 
write. They often make use of global 
variables for things like files and mem- 
ory handles, so that allocated re- 
sources can be cleaned up after an 
error. And we all know that global 
variables are generally bad news. 


It’s even worse for C++. If any of the 
intermediate functions contain objects 
with destructors, then the use of 
longjmp() almost certainly means 
that the destructors won’t be called: 
disaster. Exceptions are designed to 
solve this problem for us, although 
they introduce quirks all of their own. 


Take a peek at Figure 2. The call of 
£1() is inside a try-block. The call of 
f£1() calls £2(), which ‘throws’ an 
unnamed object of type myerror. 
Rather like Long mp (), this takes us 
back up to main (), and we enter the 
catch block. The critical factor is that 
if £1() or £2() had created any 
objects with destructors, the destruc- 
tors would be called. 


The thrown object is called an excep- 
tion. The catch block is an exception 
handler. 


Just what can be done with this magic 
will be explored next time. 


EXE 


Mike Banahan is chairman of the Euro- 
pean C++ User Group, and may be 
emailed asmikeb@hoskyns.co.uk. 
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Pointers, lvalues and rvalues 


Francis Glassborow worries about the difference between the container and the contained. 


I was recently teaching C++ to a group 
of programmers who had never used 
pointers. I had to explain the concept of 
pointers before going on to references. I 
am not sure that I succeeded as well as I 
should have - so since then I have tried to 
clarify my understanding of why pointers 
are difficult to grasp. 

Consider the C++ line ‘x = x;’. Mostly 
we do not distinguish between the two 
occurrences of x, though they are funda- 
mentally different. In computer terms there 
is a hidden dereferencing on the right of 
the assignment to get the rvalue (contents) 
of x from the lvalue (container). It is here 
that our problems start. Distinguishing be- 
tween lvalues and rvalues is so intuitive 
that we never stop to understand exactly 
what is going on. 

A pointer in C is a variable for storing 
Ivalues, Once we allow storage and use of 
lvalues, we need to understand which type 
of value our current use expects. This is 
potentially confusing, because when we 


talk about x we often do so without any 
explicit context: 


int x=5,y; /* create storage re- 
ferred to as x and store 5 in 
it, and get storage referred 
to as y.*/ 
int *px; /* create some stor- 
age for the lvalue of an int 
variable, ie to store a con- 
tainer for an int. */ 
PX=&X; /* get the lvalue of x 
- container of an int - and 
save it in the container for 
int containers called px */ 
*px=6; /* put 6 (an rvalue) 
into container contained in px 
*/ 
y=*px; 
This last statement says ‘get the contents 
- rvalue - (px is on the right of an assign- 
ment) of the container contained in px 
(because of the *) and store the result in 
the container (Ivalue because it is left of 
the assignment operator) referred to as y. 
C++ allows you to do one extra thing: 
you can add extra names to refer to the 
same storage. These are called references. 


They may be either fixed references, such 
as local or global reference variables, or 
they may be reference parameters used to 
create a local alias for storage known to 
the calling function by another name. Just 
to help confuse you further, an & is used 
to identify a reference name at the place 
where it is declared so the compiler knows 
what you are doing. 

‘int’ &z=x’ means create another name 
to refer to storage x, checking that x is an 
int. *px above temporarily behaves like 
x, but z is another name for x. *px can 
be changed to behave like something else 
(eg px=&y causes *px to behave like y), 
z cannot change meaning because it is x 
in every way but name. 


[EXE] 


CUG Subscriptions: individual £12, stu- 
dent £6, corporate £50. For further infor- 
mation about CUG(UK) write to Francis 
Glassborow at 64 Southfield Road, Oxford, 
OX4 1PA or ring 0865 246490. 
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WATFORD. | 2 
A CTI S and self motivated, 
not necessarily, in a UNIX 

trainers, technical and support staff. 


want to 
and have gained some 
environment and now want to 
F | RST progress further, speak to us. 
We have opportunities for 
You should have experience in any of 


reach the top 
SPEAK TO 22 
If you are ambitious 
experience, probably but 
programmers, software engineers, 
the following: 


C, C++ Programming 
INGRES/ORACLE/UNIFY/SYBASE 
INFORMIX (4GL and SQL) 
UNIX, OS9, X.25 
COBOL, MODULA-2 
PLCs, ASSEMBLERS 
PROCESS CONTROL 


Telephone IAN SHAW on 0204 20200 
or send your CV to ACTIS RECRUITMENT 
17 CHORLEY NEW ROAD, BOLTON BL1 4QR 
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*Unix is a trademark of AT&T 


"ED’s features are some of the most AT L AST, a full-featured 


powerful PC WEEK Labs has seen in 
a Windows programming editor." Windows and DOS 


"ED offers a series of nice touches developer’s editor is HERE! 


typical of products far more 
mature than this" 
US PC WEEK, Aug 10, 92 


Stop typing, start developing. ED gives you the absolute 
leading edge in programmer’s editors. Discover the 
tool for DOS and Windows that frees you from 
the tedium of editing and lets your creative 

\ instincts flow! 


Key Features: 
© Language sensitive editing for. C, C++, dBase, Clipper... 


"ED has © Smart code indenting, code templates and auto-completion 

obviously been ZN © Hypertext function/procedure lookups 

well thought out by © Windows Toolbar 

a software developer as © Unlimited Undo and Redo 

a ’dream come true’ tool for Y © Column and stream blocks 

other software developers." Y © Comprehensive context-sensitive 

UK British Aerospace, Aug 92 help 

© Keyboard macros & remapping |, 

© Emulation of popular editors 
(Brief, Wordstar, Qedit...) 

© Printing with font selection, 
headings and line numbers. 


"ED has unique capabilities that make 
you think, ’Why didn’t | think of that"” 


"This is one editor that is well worth 

keeping an eye o Power Features: 

US Windows Tech Journal, Aug 92 © Fast C extension language, 
with 800K+ of source 

© Context sensitive Windows 


SDK Help 
"ED is THE most comprehensive, © Regular expressions, search 
flexible, tailorable and productive across files, selective display 
editor the evaluation team has ever and incremental search 
seen. It far excels editors such as @ LAN file-locking and 
Brief, Winedit, Qedit..." multiuser support 
UK British Aerospace, Aug 92 © Virtual memory engine 


handles huge files 
© Built-in background Compiler support with error tracking 


Contact your local dealer for a free demonstration disk 


UK Distributor:- Germany Distributor :- Dutch Distributor: 
QBS Software Limited DC Soft GmBH Markus Software 

10 Barley Mow Passage Machtifinger Strasse 26 Kapellerlaan 40 
Chiswick, London W4 4PH 8000 Miinchen 70 6041 JD Roermond 
United Kingdom Germany The Netherlands 

Tel : (+44) 81 994 4842 Tel: (+49) 89 785 8910 Tel: (+31) 47 50 32555 
Fax: (+44) 81 994 3441 Fax: (+49) 89 785 89111 Fax: (+31) 47 50 35577 
BBS: (+44) 81 747 1979 BBS: (+49) 89 785 89117 BBS: (31) 47 50 36393 
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POET/Object Oriented Database 


Applied Logic 


Object Oriented Programming 
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Programmers Utility 


Basic Magazine 


Basic Programmers Magazine. 


Premia 


Bits per Second 


Graphics Tools 
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QAI 


Programming Tools 
Training 
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BL Computer Security 1 


Software Security Dongle Offer 


BL Computer Security Il 


Software Security Dongle 
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Training 
Clipper 


Blink Inc. 


Fast Linker 


QBS II 


Clipper 


Borland 


Pascal 7.0 


Quantec 


Development Too! Kit 


Brent Communications 


MAX Copy Protection 


R&R 


Report Writer 


Citadel Software 


Comms Library 


Rainbow Technologies 


Security Products 


DES 


Software Protection 


Readmar 


Version Control 


Digital 


Workstation 


Richfords 


Training 


Digital il 


Workstation 


European C+ User Group 


C++ Technical Conference 


2/8/28) 28/8) 


Salford Software 


Fortran for DOS & UNIX 


Select Software Tools 


C++ 


Expotech 


Programming Tools 


Forté Software Tools 


Version Control 


Silica Systems | 
Silica Systems II 


Hardware 
Hardware 


Frontline Distribution 


DEC Workstation 


Softlok 


Piracy Protection 


Grey Matter 


Programming Tools 


Software Con Co. 
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Programming Tools 


Grumpfish 


Clipper 


Software Design & Builders 


Inmark 
Inst, Analysts/Progmrs 
Intasoft 


C++ Application Framework 
Institute 


Software Security 


Workshop 
Security Dongles 


Version Control 
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SPC 
System Science 


Superbase 
Programming Tools 


LPA 


AI/KB/OOPS Software 


Magnifeye 


Software Protection Device 


SystemStar SoftTools Ltd 


Programming Tools 


Media Cybernetics 


Programming Tools 


Trevan Design 
User Friendly 


MKS 


MKS Toolkit 


Watcom 


Bulletin Board 
Software Copy Control 
Programming Tools 


NAG 


Fortran 90 


Nu Moga 


Debugging Tools 


Zine 


GUI Library 


STO0B - Inferno 


‘A Descent into Hell’ was how Virus Bulletin described the notorious ‘Hell-pit’ Californian bulletin board. 
Verity ‘Dante’ Stob borrowed an enemy's machine and logged on. 


The Lewis Virus. Attacks DOS .EXE 
files. An infection is easily detected, as 
whenever it successfully transfers itself 
to a new file, it prints the message ‘Well 
done Lewis, you’ve done it again!’. Trig- 
ger: if an infected program is run be- 
tween 8.00pm and 10.00pm of a 
Wednesday evening, the screen displays 
‘| know what Morse’s first name is!, 
Narney-narney noo nah!’, to the accom- 
paniment of a series of tuneless bleeps, 
composed by Barrington Pheloung, 
played on the speaker. This noise may 
well be the good Inspector's name in 
Morse code; unfortunately nobody at this 
office was sufficiently interested to work 
it out. Byte detection pattern: 


45 72 69 63 45 64 67 61 EricEdga 
72 45 6C 76 69 73 45 64 rElvisEd 
77 61 72 64 45 7A 72 61 wardEzra 


Basic Attack. Despite a claim by the 
author, embedded as a string in the code, 
that this is ‘the most virulent virus of all 
time’, we were unable to verify this as it 
fell over on installation, apparently be- 
cause of an incompatibility with our VGA 


.EXE Magazine, Vol 7, Issue 9, March 1993 


card. To be fair, technical support was 
very helpful, and suggested that there 
might also be a problem with our mem- 
ory manager. Requires a 33 Mhz 486 
machine with at least 8 MB RAM (10 MB 
recommended) and Visual Basic runtime 
DLL. 

Camillagate. A scourge of Windows 
applications. Camillagate intercepts the 
Alt-F4 (exit application) keystroke, and 
puts up a system modal dialog which 
reads, ‘Bye-bye, then!’. When the victim 
OKs the dialog, another is displayed with 
the message, ‘Love youl’. After that 
comes ‘Kissy-kissy’, ‘Go on, press the tit, 
then’, ‘Love you, sweedledums!’, ‘Ta-ta’, 
‘Must fly’, ‘Goodbye darling!’, ‘See you 
soon, dingle-drawers’ and so on, until 
the frustrated user resets his machine. 
Detection pattern: 


49 20 72 65 61 6C 6C 79 I really 
20 77 61 6E 74 20 74 6F want to 
20 62 65 20 61 20 74 61 be a tam 


OS/2 2.0 A notorious boot sector 
virus, it is usually detected by the disap- 
pearance of vast amounts of disk space, 


and a notable reduction in the perform- 
ance of machines, especially those with 
less than 16 MB of memory. Many Win- 
dows programs will run so slowly as to 
be unusable, and enhanced mode appli- 
cations will not run at all. OS/2 2.0 has 
an interesting distribution vector - al- 
though it is available on bulletin boards, 
it tends to arrive in a brightly coloured 
box labelled ‘A better DOS than DOS, a 
better Windows than Window’, and thus 
cruelly exploits the gullibility and lack of 
virus awareness of the average user. 
Some claim that a giant, sinister organi- 
sation is behind the spreading of OS/2 
2.0, but we have found no evidence of 
this. In spite of enormous publicity, OS/2 
2.0 is still quite rare. (NB: OS/2 2.0 fans 
please don’t write in - just substitute the 
phrase ‘Windows NT’ for ‘OS/2 2.0’ 
throughout the above paragraph and 
smile like a good ’un.) 

Delhi Belly. AKA ‘Gower’s Revenge’. 
Attacks all programs in the root directory. 
When an infected application is run, it 
prints out the complete score-card of the 


recent Indian Tests. 
EXE} 
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TRAINING AND CONSULTANCY 


Computer professionals know that QA 
provides the best technical workstation 
training, giving them skills in new 
technologies and keeping them up-to-date 
with the latest developments. 

Accelerate your learning curve with a QA 
course, either in one of our fully equipped 


training centres or delivered ‘in house’ for 


you and your team. 


QA can help you make best use of Unix workstations or servers 
with Fundamentals, Administration, Networking and Programming 
cours 


WINDOWS 

Voted the Best Windows Training Company of 1992, QA’s 
exp nce in Windows is unrivalled, with cours 
programmers, support staff and users. QA is first for Windows/NT 
training too, 


OS/2 

Complete coverage of OS/2 including programming 
and support, the extended services components, 
OS/2 Lans and even courses fo: time users of the 
Workplace Shell. 


NETWORKS 

From planning to implementation, support to 

nming, QA has extensive training in Novell 
are (NAEC), Microsoft Lan Manager, IBM 

OS/2 Lan Server and Unix networking. Datacomms 


for 


training too. 


Mail to QA Training, Cecily Hill Castle, Cirencester, 
Gloucestershire, GL7 2EF. UK. 
Tick here for full details. 


TRAINING Object-Oriented 
[_] unix/Aix Support 
[_] Windows |_| Databases 
osi2 CONSULTANCY 
Networks [| SOFTWARE 
DEVELOPMENT 
Languages PRODUCTS 


ACCELERS® 
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LANGUAG 
QA is the UK’s premier C and G++ training organisation. We have 
taught thousands of delegates good, structured, efficient C and C++ 


programming style. 


OBJECT-ORIENTED TECHNOLOGY 

From introductory courses and management overviews to 

nd Design, QA provides a complete 
education in the principles and practice of Object Technology. 


PPORT 

Manage PCs and Workstations better with hardware 
and software support training for DOS, Windows, 
OS/2 and Unix. 


DATABASES and CLIENT-SERVER 

he most up-to-date training in database, SQL and 
lient-Server technology. Lotus Notes, SQL Server 
_ and Database Manager support and programming 
are included. 


sophisticated Analysis 


For more information, please complete and 
return the coupon today, or call Samantha 
_ Trinder on 0285 655888. 
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If you want an Application Framework that will 
simplify Windows programming, zApp is better 
than Borland’s OWL or Microsoft’s MFC. And 
zApp’s portability makes it the world class leader. 


OBJECTWINDOWS 
FOR CH 


WINDOWS 3.X 


user's cue 


zApp outclasses Borland. “zApp...implements 


the same general concepts as Borlana’s Object Windows ee 
(Library), but takes them significantly further... ‘ |. 
The xApp class library is larger than OWL’s and 

Se 


much richer.”—Jeff Dunteman, PC Techniques. Secular 
‘The zApp class library provides nearly 200 object 
classes for creating even sophisticated applications without hassling with the Windows API. OWL’s 50 


ieee 


WINDOWS NT 
classes have such limited coverage that creating a basic “Hello World” application (Petzold’s Programming 
Windows) forces you to program the Windows API directly. zApp gives you a@// the classes you need. 


zApp ovtclasses Microsoft. “zApp’s model of Windows is not an object-oriented wrapper (as in 
ween (1/107 050ft'5 Foundation Classes)... Rather, zApp offers the most comprehensive, object-oriented approach I’ve seen 
bos to Windows.” — Richard Hale Shaw, Windows Tech Journal. Vf you want an Application Framework to free 
you from grappling with the hard-to-use Windows API, zApp does it better than MFC. In fact, Richard 
Hale Shaw points out that MFC “might as well be Windows” and the MFC Users Guide even admits that 
it is “really a direct C++ wrapping of the familiar C functions for Windows” Because zApp presents a 
more powerful interface to Windows, zApp can reduce your code length by over 60% compared to MFC, 


zApp gives you portability that OWL and MFC don’t. With zApp, you can support multiple 
platforms today and know that your code will run on the platforms of tomorrow. zApp provides you with 
single source code compatibility between Windows" Windows NT" DOS, OS/2"' and soon, X/Motif™ 


Sample zApp now. Call Systemstar on (0992) 500919 for a free zApp Demonstration Program 
and see zApp’s classes and several sample programs with source code. Better yet, try zApp with 
our 60-day unconditional money-back guarantee. You’ll know a class act when you see one. 


Graphics classes Advanced Message aT 
Hee ae Bap Handling — UNE FOR A 
rinter, and Metafile: bs ita oo i 
fara ject Pers! i 
Pale ons pes Wises ean cea grams, LIMITED 
Pane aaa eu Seppart 1 tutorials anc 450 page Tl ME ; 
3 Fo SaeRtOn ‘tee Phas Programmers Reference a With your 
Over 35 Window classes Repeat n Lesieal ‘ nd ‘ ' order of zApp, we'll 
including Application, Dialog, Data Entry classes Dimenstoning ¢ send you 


MDI, All standard Controls, 


include Text, Picture String, 


including English, Metric, 


Common Dialogs, and access Numeric, Date, Time, Dialog Unit, Printer Point, 
to Custom Controls Radio Group, Checkbox, and Pica 
Mens including standard, OMAR Advanced MDI Support 
system, and popup Support for OLE and DDE Automated Window No Runtime Royalty 
Positioning requirements ‘ 


YSTEMSTAR 
SoftTools Limited 


1-3 Parliament Square Hertford SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 554261 


NMARK 2065 LANDINGS DRIVE, MOUNTAINVIEW, CA 94043 

| All product names referenced herein are trademarks of their respective companies. 
THE RED HOUSE BLUECOATS HERTFORD SG14 1AX 
TELEPHONE: (0992) 500919 FACSIMILE: (0992) 554261 
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